@storacha/client
Version:
Client for the storacha.network w3up api
76 lines • 2.83 kB
JavaScript
import { Upload } from '@storacha/upload-client';
import { Upload as UploadCapabilities } from '@storacha/capabilities';
import { Base } from '../base.js';
import { UploadShardClient } from './upload/shard.js';
/**
* Client for interacting with the `upload/*` capabilities.
*/
export class UploadClient extends Base {
/**
* @param {import('@storacha/access').AgentData} agentData
* @param {object} [options]
* @param {import('../types.js').ServiceConf} [options.serviceConf]
* @param {URL} [options.receiptsEndpoint]
*/
constructor(agentData, options) {
super(agentData, options);
this.shard = new UploadShardClient(agentData, options);
}
/**
* Register an "upload" to the resource.
*
* Required delegated capabilities:
* - `upload/add`
*
* @param {import('../types.js').UnknownLink} root - Root data CID for the DAG that was stored.
* @param {import('../types.js').CARLink[]} shards - CIDs of CAR files that contain the DAG.
* @param {import('../types.js').RequestOptions} [options]
*/
async add(root, shards, options = {}) {
const conf = await this._invocationConfig([UploadCapabilities.add.can]);
options.connection = this._serviceConf.upload;
return Upload.add(conf, root, shards, options);
}
/**
* Get details of an "upload".
*
* Required delegated capabilities:
* - `upload/get`
*
* @param {import('../types.js').UnknownLink} root - Root data CID for the DAG that was stored.
* @param {import('../types.js').RequestOptions} [options]
*/
async get(root, options = {}) {
const conf = await this._invocationConfig([UploadCapabilities.get.can]);
options.connection = this._serviceConf.upload;
return Upload.get(conf, root, options);
}
/**
* List uploads registered to the resource.
*
* Required delegated capabilities:
* - `upload/list`
*
* @param {import('../types.js').ListRequestOptions} [options]
*/
async list(options = {}) {
const conf = await this._invocationConfig([UploadCapabilities.list.can]);
options.connection = this._serviceConf.upload;
return Upload.list(conf, options);
}
/**
* Remove an upload by root data CID.
*
* Required delegated capabilities:
* - `upload/remove`
*
* @param {import('../types.js').UnknownLink} root - Root data CID to remove.
* @param {import('../types.js').RequestOptions} [options]
*/
async remove(root, options = {}) {
const conf = await this._invocationConfig([UploadCapabilities.remove.can]);
options.connection = this._serviceConf.upload;
return Upload.remove(conf, root, options);
}
}
//# sourceMappingURL=upload.js.map