@autonomys/auto-drive 1.0.2 → 1.0.4

package/dist/api/calls/download.d.ts

@@ -0,0 +1,6 @@
+import { ArgsWithoutPagination } from '../../utils/types.js';
+import { AutoDriveApi } from '../connection.js';
+export declare const downloadObject: (api: AutoDriveApi, query: ArgsWithoutPagination<{
+    cid: string;
+}>) => Promise<ReadableStream<Uint8Array>>;
+//# sourceMappingURL=download.d.ts.map

package/dist/api/calls/download.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"download.d.ts","sourceRoot":"","sources":["../../../src/api/calls/download.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,qBAAqB,EAAE,MAAM,sBAAsB,CAAA;AAC5D,OAAO,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAA;AAE/C,eAAO,MAAM,cAAc,QACpB,YAAY,SACV,qBAAqB,CAAC;IAAE,GAAG,EAAE,MAAM,CAAA;CAAE,CAAC,KAC5C,OAAO,CAAC,cAAc,CAAC,UAAU,CAAC,CAcpC,CAAA"}

package/dist/api/calls/download.js

@@ -0,0 +1,21 @@
+var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
+    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
+    return new (P || (P = Promise))(function (resolve, reject) {
+        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
+        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
+        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
+        step((generator = generator.apply(thisArg, _arguments || [])).next());
+    });
+};
+export const downloadObject = (api, query) => __awaiter(void 0, void 0, void 0, function* () {
+    const response = yield api.sendRequest(`/objects/${query.cid}/download`, {
+        method: 'GET',
+    });
+    if (!response.ok) {
+        throw new Error(`Failed to download file: ${response.statusText}`);
+    }
+    if (!response.body) {
+        throw new Error('No body returned from download request');
+    }
+    return response.body;
+});

package/dist/api/calls/index.d.ts

@@ -0,0 +1,5 @@
+export * from './download.js';
+export * from './read.js';
+export * from './upload.js';
+export * from './write.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/api/calls/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/api/calls/index.ts"],"names":[],"mappings":"AAAA,cAAc,eAAe,CAAA;AAC7B,cAAc,WAAW,CAAA;AACzB,cAAc,aAAa,CAAA;AAC3B,cAAc,YAAY,CAAA"}

package/dist/api/calls/index.js

@@ -0,0 +1,4 @@
+export * from './download.js';
+export * from './read.js';
+export * from './upload.js';
+export * from './write.js';

package/dist/api/calls/read.d.ts

@@ -0,0 +1,98 @@
+import { ArgsWithoutPagination, ArgsWithPagination } from '../../utils/types.js';
+import { AutoDriveApi } from '../connection.js';
+import { ObjectInformation, ObjectSummary, Scope } from '../models/objects.js';
+/**
+ * Retrieves the root objects based on the specified scope.
+ *
+ * @param {AutoDriveApi} api - The API instance used to send requests.
+ * @param {ArgsWithPagination<{ scope: Scope }>} query - The query parameters including scope, limit, and offset.
+ * @returns {Promise<ObjectSummary[]>} - A promise that resolves to an array of ObjectSummary representing the root objects.
+ * @throws {Error} - Throws an error if the request fails.
+ */
+export declare const getRoots: (api: AutoDriveApi, query: ArgsWithPagination<{
+    scope: Scope;
+}>) => Promise<ObjectSummary[]>;
+/**
+ * Retrieves the objects that have been shared with the authenticated user.
+ *
+ * This method sends a request to the server to fetch a list of objects
+ * that are shared with the user, based on the specified pagination parameters.
+ *
+ * @param {AutoDriveApi} api - The API instance used to send requests.
+ * @param {ArgsWithPagination} query - The query parameters including limit and offset for pagination.
+ * @returns {Promise<ObjectSummary[]>} - A promise that resolves to an array of ObjectSummary representing the shared objects.
+ * @throws {Error} - Throws an error if the request fails.
+ */
+export declare const getSharedWithMe: (api: AutoDriveApi, query: ArgsWithPagination) => Promise<ObjectSummary[]>;
+/**
+ * Retrieves the objects that have been marked as deleted.
+ *
+ * This method sends a request to the server to fetch a list of objects
+ * that have been deleted, based on the specified pagination parameters.
+ *
+ * @param {AutoDriveApi} api - The API instance used to send requests.
+ * @param {ArgsWithPagination} query - The query parameters including limit and offset for pagination.
+ * @returns {Promise<ObjectSummary[]>} - A promise that resolves to an array of ObjectSummary representing the deleted objects.
+ * @throws {Error} - Throws an error if the request fails.
+ */
+export declare const getDeleted: (api: AutoDriveApi, query: ArgsWithPagination) => Promise<ObjectSummary[]>;
+/**
+ * Retrieves the aggregated information of a specific object identified by its CID.
+ *
+ * This method sends a request to the server to fetch details about the
+ * object, including its metadata and other relevant information.
+ *
+ * @param {AutoDriveApi} api - The API instance used to send requests.
+ * @param {ArgsWithoutPagination<{ cid: string }>} query - The query parameters containing the CID of the object to retrieve.
+ * @returns {Promise<ObjectInformation>} - A promise that resolves to the information of the requested object.
+ * @throws {Error} - Throws an error if the request fails.
+ */
+export declare const getObject: (api: AutoDriveApi, query: ArgsWithoutPagination<{
+    cid: string;
+}>) => Promise<ObjectInformation>;
+/**
+ * Retrieves the upload status of a specific object identified by its CID.
+ *
+ * This method sends a request to the server to fetch the current upload status
+ * of the object, which can indicate whether the upload is pending, completed,
+ * or failed.
+ *
+ * @param {AutoDriveApi} api - The API instance used to send requests.
+ * @param {ArgsWithoutPagination<{ cid: string }>} query - The query parameters containing the CID of the object whose upload status is to be retrieved.
+ * @returns {Promise<ObjectInformation['uploadStatus']>} - A promise that resolves to the upload status of the requested object.
+ * @throws {Error} - Throws an error if the request fails.
+ */
+export declare const getObjectUploadStatus: (api: AutoDriveApi, query: ArgsWithoutPagination<{
+    cid: string;
+}>) => Promise<ObjectInformation["uploadStatus"]>;
+/**
+ * Retrieves the owners of a specific object identified by its CID.
+ *
+ * This method sends a request to the server to fetch the list of owners
+ * associated with the object. The owners can provide insights into who
+ * has access to or control over the object.
+ *
+ * @param {AutoDriveApi} api - The API instance used to send requests.
+ * @param {ArgsWithoutPagination<{ cid: string }>} query - The query parameters containing the CID of the object whose owners are to be retrieved.
+ * @returns {Promise<ObjectInformation['owners']>} - A promise that resolves to the list of owners of the requested object.
+ * @throws {Error} - Throws an error if the request fails.
+ */
+export declare const getObjectOwners: (api: AutoDriveApi, query: ArgsWithoutPagination<{
+    cid: string;
+}>) => Promise<ObjectInformation["owners"]>;
+/**
+ * Retrieves the metadata of a specific object identified by its CID.
+ *
+ * This method sends a request to the server to fetch the metadata associated
+ * with the object. The metadata can include various details about the object,
+ * such as its name, type, size, and other relevant information.
+ *
+ * @param {AutoDriveApi} api - The API instance used to send requests.
+ * @param {ArgsWithoutPagination<{ cid: string }>} query - The query parameters containing the CID of the object whose metadata is to be retrieved.
+ * @returns {Promise<ObjectInformation['metadata']>} - A promise that resolves to the metadata of the requested object.
+ * @throws {Error} - Throws an error if the request fails.
+ */
+export declare const getObjectMetadata: (api: AutoDriveApi, query: ArgsWithoutPagination<{
+    cid: string;
+}>) => Promise<ObjectInformation["metadata"]>;
+//# sourceMappingURL=read.d.ts.map

package/dist/api/calls/read.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"read.d.ts","sourceRoot":"","sources":["../../../src/api/calls/read.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,qBAAqB,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAA;AAChF,OAAO,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAA;AAC/C,OAAO,EAAE,iBAAiB,EAAE,aAAa,EAAE,KAAK,EAAE,MAAM,sBAAsB,CAAA;AAE9E;;;;;;;GAOG;AACH,eAAO,MAAM,QAAQ,QACd,YAAY,SACV,kBAAkB,CAAC;IAAE,KAAK,EAAE,KAAK,CAAA;CAAE,CAAC,KAC1C,OAAO,CAAC,aAAa,EAAE,CAazB,CAAA;AAED;;;;;;;;;;GAUG;AACH,eAAO,MAAM,eAAe,QACrB,YAAY,SACV,kBAAkB,KACxB,OAAO,CAAC,aAAa,EAAE,CAazB,CAAA;AAED;;;;;;;;;;GAUG;AACH,eAAO,MAAM,UAAU,QAChB,YAAY,SACV,kBAAkB,KACxB,OAAO,CAAC,aAAa,EAAE,CAazB,CAAA;AAED;;;;;;;;;;GAUG;AACH,eAAO,MAAM,SAAS,QACf,YAAY,SACV,qBAAqB,CAAC;IAAE,GAAG,EAAE,MAAM,CAAA;CAAE,CAAC,KAC5C,OAAO,CAAC,iBAAiB,CAU3B,CAAA;AAED;;;;;;;;;;;GAWG;AACH,eAAO,MAAM,qBAAqB,QAC3B,YAAY,SACV,qBAAqB,CAAC;IAAE,GAAG,EAAE,MAAM,CAAA;CAAE,CAAC,KAC5C,OAAO,CAAC,iBAAiB,CAAC,cAAc,CAAC,CAU3C,CAAA;AAED;;;;;;;;;;;GAWG;AACH,eAAO,MAAM,eAAe,QACrB,YAAY,SACV,qBAAqB,CAAC;IAAE,GAAG,EAAE,MAAM,CAAA;CAAE,CAAC,KAC5C,OAAO,CAAC,iBAAiB,CAAC,QAAQ,CAAC,CAUrC,CAAA;AAED;;;;;;;;;;;GAWG;AACH,eAAO,MAAM,iBAAiB,QACvB,YAAY,SACV,qBAAqB,CAAC;IAAE,GAAG,EAAE,MAAM,CAAA;CAAE,CAAC,KAC5C,OAAO,CAAC,iBAAiB,CAAC,UAAU,CAAC,CAUvC,CAAA"}

package/dist/api/calls/read.js

@@ -0,0 +1,149 @@
+var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
+    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
+    return new (P || (P = Promise))(function (resolve, reject) {
+        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
+        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
+        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
+        step((generator = generator.apply(thisArg, _arguments || [])).next());
+    });
+};
+/**
+ * Retrieves the root objects based on the specified scope.
+ *
+ * @param {AutoDriveApi} api - The API instance used to send requests.
+ * @param {ArgsWithPagination<{ scope: Scope }>} query - The query parameters including scope, limit, and offset.
+ * @returns {Promise<ObjectSummary[]>} - A promise that resolves to an array of ObjectSummary representing the root objects.
+ * @throws {Error} - Throws an error if the request fails.
+ */
+export const getRoots = (api, query) => __awaiter(void 0, void 0, void 0, function* () {
+    const response = yield api.sendRequest(`/objects/roots?scope=${query.scope}&limit=${query.limit}&offset=${query.offset}`, {
+        method: 'GET',
+    });
+    if (!response.ok) {
+        throw new Error(`Failed to get roots: ${response.statusText}`);
+    }
+    return response.json();
+});
+/**
+ * Retrieves the objects that have been shared with the authenticated user.
+ *
+ * This method sends a request to the server to fetch a list of objects
+ * that are shared with the user, based on the specified pagination parameters.
+ *
+ * @param {AutoDriveApi} api - The API instance used to send requests.
+ * @param {ArgsWithPagination} query - The query parameters including limit and offset for pagination.
+ * @returns {Promise<ObjectSummary[]>} - A promise that resolves to an array of ObjectSummary representing the shared objects.
+ * @throws {Error} - Throws an error if the request fails.
+ */
+export const getSharedWithMe = (api, query) => __awaiter(void 0, void 0, void 0, function* () {
+    const response = yield api.sendRequest(`/objects/roots/shared?limit=${query.limit}&offset=${query.offset}`, {
+        method: 'GET',
+    });
+    if (!response.ok) {
+        throw new Error(`Failed to get shared with me: ${response.statusText}`);
+    }
+    return response.json();
+});
+/**
+ * Retrieves the objects that have been marked as deleted.
+ *
+ * This method sends a request to the server to fetch a list of objects
+ * that have been deleted, based on the specified pagination parameters.
+ *
+ * @param {AutoDriveApi} api - The API instance used to send requests.
+ * @param {ArgsWithPagination} query - The query parameters including limit and offset for pagination.
+ * @returns {Promise<ObjectSummary[]>} - A promise that resolves to an array of ObjectSummary representing the deleted objects.
+ * @throws {Error} - Throws an error if the request fails.
+ */
+export const getDeleted = (api, query) => __awaiter(void 0, void 0, void 0, function* () {
+    const response = yield api.sendRequest(`/objects/roots/deleted?limit=${query.limit}&offset=${query.offset}`, {
+        method: 'GET',
+    });
+    if (!response.ok) {
+        throw new Error(`Failed to get deleted: ${response.statusText}`);
+    }
+    return response.json();
+});
+/**
+ * Retrieves the aggregated information of a specific object identified by its CID.
+ *
+ * This method sends a request to the server to fetch details about the
+ * object, including its metadata and other relevant information.
+ *
+ * @param {AutoDriveApi} api - The API instance used to send requests.
+ * @param {ArgsWithoutPagination<{ cid: string }>} query - The query parameters containing the CID of the object to retrieve.
+ * @returns {Promise<ObjectInformation>} - A promise that resolves to the information of the requested object.
+ * @throws {Error} - Throws an error if the request fails.
+ */
+export const getObject = (api, query) => __awaiter(void 0, void 0, void 0, function* () {
+    const response = yield api.sendRequest(`/objects/${query.cid}`, {
+        method: 'GET',
+    });
+    if (!response.ok) {
+        throw new Error(`Failed to get object: ${response.statusText}`);
+    }
+    return response.json();
+});
+/**
+ * Retrieves the upload status of a specific object identified by its CID.
+ *
+ * This method sends a request to the server to fetch the current upload status
+ * of the object, which can indicate whether the upload is pending, completed,
+ * or failed.
+ *
+ * @param {AutoDriveApi} api - The API instance used to send requests.
+ * @param {ArgsWithoutPagination<{ cid: string }>} query - The query parameters containing the CID of the object whose upload status is to be retrieved.
+ * @returns {Promise<ObjectInformation['uploadStatus']>} - A promise that resolves to the upload status of the requested object.
+ * @throws {Error} - Throws an error if the request fails.
+ */
+export const getObjectUploadStatus = (api, query) => __awaiter(void 0, void 0, void 0, function* () {
+    const response = yield api.sendRequest(`/objects/${query.cid}/status`, {
+        method: 'GET',
+    });
+    if (!response.ok) {
+        throw new Error(`Failed to get object: ${response.statusText}`);
+    }
+    return response.json();
+});
+/**
+ * Retrieves the owners of a specific object identified by its CID.
+ *
+ * This method sends a request to the server to fetch the list of owners
+ * associated with the object. The owners can provide insights into who
+ * has access to or control over the object.
+ *
+ * @param {AutoDriveApi} api - The API instance used to send requests.
+ * @param {ArgsWithoutPagination<{ cid: string }>} query - The query parameters containing the CID of the object whose owners are to be retrieved.
+ * @returns {Promise<ObjectInformation['owners']>} - A promise that resolves to the list of owners of the requested object.
+ * @throws {Error} - Throws an error if the request fails.
+ */
+export const getObjectOwners = (api, query) => __awaiter(void 0, void 0, void 0, function* () {
+    const response = yield api.sendRequest(`/objects/${query.cid}/owners`, {
+        method: 'GET',
+    });
+    if (!response.ok) {
+        throw new Error(`Failed to get object: ${response.statusText}`);
+    }
+    return response.json();
+});
+/**
+ * Retrieves the metadata of a specific object identified by its CID.
+ *
+ * This method sends a request to the server to fetch the metadata associated
+ * with the object. The metadata can include various details about the object,
+ * such as its name, type, size, and other relevant information.
+ *
+ * @param {AutoDriveApi} api - The API instance used to send requests.
+ * @param {ArgsWithoutPagination<{ cid: string }>} query - The query parameters containing the CID of the object whose metadata is to be retrieved.
+ * @returns {Promise<ObjectInformation['metadata']>} - A promise that resolves to the metadata of the requested object.
+ * @throws {Error} - Throws an error if the request fails.
+ */
+export const getObjectMetadata = (api, query) => __awaiter(void 0, void 0, void 0, function* () {
+    const response = yield api.sendRequest(`/objects/${query.cid}/metadata`, {
+        method: 'GET',
+    });
+    if (!response.ok) {
+        throw new Error(`Failed to get object: ${response.statusText}`);
+    }
+    return response.json();
+});

package/dist/api/calls/upload.d.ts

@@ -0,0 +1,94 @@
+import { FileUploadOptions } from '@autonomys/auto-dag-data';
+import { ArgsWithoutPagination } from '../../utils/types.js';
+import { AutoDriveApi } from '../connection.js';
+import { FolderTree } from '../models/folderTree.js';
+import { CompleteUploadResponse, FileUpload, FolderUpload } from '../models/uploads.js';
+/**
+ * Initiates a file upload to the server.
+ *
+ * @param {AutoDriveApi} api - The API instance used to send requests.
+ * @param {ArgsWithoutPagination<{ mimeType?: string; filename: string; uploadOptions: FileUploadOptions | null }>} args - The arguments for the file upload.
+ * @param {string} args.mimeType - The MIME type of the file (optional).
+ * @param {string} args.filename - The name of the file to be uploaded.
+ * @param {FileUploadOptions | null} args.uploadOptions - Additional options for the file upload (optional).
+ * @returns {Promise<FileUpload>} - A promise that resolves to the file upload information.
+ * @throws {Error} - Throws an error if the upload fails.
+ */
+export declare const createFileUpload: (api: AutoDriveApi, { mimeType, filename, uploadOptions, }: ArgsWithoutPagination<{
+    mimeType?: string;
+    filename: string;
+    uploadOptions: FileUploadOptions | null;
+}>) => Promise<FileUpload>;
+/**
+ * Initiates a folder upload to the server.
+ *
+ * @param {AutoDriveApi} api - The API instance used to send requests.
+ * @param {ArgsWithoutPagination<{ fileTree: FolderTree; uploadOptions: FileUploadOptions }>} args - The arguments for the folder upload.
+ * @param {FolderTree} args.fileTree - The structure of the folder and its contents to be uploaded.
+ * @param {FileUploadOptions} args.uploadOptions - Additional options for the folder upload.
+ * @returns {Promise<FolderUpload>} - A promise that resolves to the folder upload information.
+ * @throws {Error} - Throws an error if the upload fails.
+ */
+export declare const createFolderUpload: (api: AutoDriveApi, { fileTree, uploadOptions, }: ArgsWithoutPagination<{
+    fileTree: FolderTree;
+    uploadOptions: FileUploadOptions;
+}>) => Promise<FolderUpload>;
+/**
+ * Creates a file upload within an existing folder upload.
+ *
+ * @param {AutoDriveApi} api - The API instance used to send requests.
+ * @param {ArgsWithoutPagination<{ uploadId: string; name: string; mimeType: string; relativeId: string; uploadOptions: FileUploadOptions }>} args - The arguments for the file upload.
+ * @param {string} args.uploadId - The ID of the folder upload to which the file will be added.
+ * @param {string} args.name - The name of the file to be uploaded.
+ * @param {string} args.mimeType - The MIME type of the file being uploaded.
+ * @param {string} args.relativeId - The relative ID of the file within the folder structure.
+ * @param {FileUploadOptions} [args.uploadOptions={}] - Additional options for the file upload.
+ * @returns {Promise<FileUpload>} - A promise that resolves to the file upload information.
+ * @throws {Error} - Throws an error if the upload fails.
+ */
+export declare const createFileUploadWithinFolderUpload: (api: AutoDriveApi, { uploadId, name, mimeType, relativeId, uploadOptions, }: ArgsWithoutPagination<{
+    uploadId: string;
+    name: string;
+    mimeType?: string;
+    relativeId: string;
+    uploadOptions: FileUploadOptions;
+}>) => Promise<FileUpload>;
+/**
+ * Uploads a chunk of a file to the server.
+ *
+ * This function allows for the uploading of a specific chunk of a file
+ * during a multi-part upload process. It sends the chunk along with its
+ * index to the server, which can be used to reconstruct the file on the
+ * server side.
+ *
+ * @param {AutoDriveApi} api - The API instance used to send requests.
+ * @param {ArgsWithoutPagination<{ uploadId: string; chunk: Buffer; index: number }>} args - The arguments for the file chunk upload.
+ * @param {string} args.uploadId - The ID of the upload session.
+ * @param {Buffer} args.chunk - The chunk of the file to be uploaded.
+ * @param {number} args.index - The index of the chunk in the overall file.
+ * @returns {Promise<void>} - A promise that resolves when the chunk is uploaded successfully.
+ * @throws {Error} - Throws an error if the upload fails.
+ */
+export declare const uploadFileChunk: (api: AutoDriveApi, { uploadId, chunk, index, }: ArgsWithoutPagination<{
+    uploadId: string;
+    chunk: Buffer;
+    index: number;
+}>) => Promise<void>;
+/**
+ * Completes a file or folder upload session on the server.
+ *
+ * This function sends a request to the server to finalize the upload
+ * process for a given upload session identified by the upload ID. It is
+ * typically called after all file chunks have been uploaded. This method
+ * can be used to complete both file and folder uploads.
+ *
+ * @param {AutoDriveApi} api - The API instance used to send requests.
+ * @param {ArgsWithoutPagination<{ uploadId: string }>} args - The arguments for completing the upload.
+ * @param {string} args.uploadId - The ID of the upload session to complete.
+ * @returns {Promise<any>} - A promise that resolves to the response from the server.
+ * @throws {Error} - Throws an error if the completion of the upload fails.
+ */
+export declare const completeUpload: (api: AutoDriveApi, { uploadId }: ArgsWithoutPagination<{
+    uploadId: string;
+}>) => Promise<CompleteUploadResponse>;
+//# sourceMappingURL=upload.d.ts.map

package/dist/api/calls/upload.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"upload.d.ts","sourceRoot":"","sources":["../../../src/api/calls/upload.ts"],"names":[],"mappings":"AAAA,OAAO,EAAO,iBAAiB,EAAE,MAAM,0BAA0B,CAAA;AACjE,OAAO,EAAE,qBAAqB,EAAE,MAAM,sBAAsB,CAAA;AAC5D,OAAO,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAA;AAC/C,OAAO,EAAE,UAAU,EAAE,MAAM,yBAAyB,CAAA;AACpD,OAAO,EAAE,sBAAsB,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAA;AAEvF;;;;;;;;;;GAUG;AACH,eAAO,MAAM,gBAAgB,QACtB,YAAY,0CAKd,qBAAqB,CAAC;IACvB,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,QAAQ,EAAE,MAAM,CAAA;IAChB,aAAa,EAAE,iBAAiB,GAAG,IAAI,CAAA;CACxC,CAAC,KACD,OAAO,CAAC,UAAU,CAiBpB,CAAA;AAED;;;;;;;;;GASG;AACH,eAAO,MAAM,kBAAkB,QACxB,YAAY,gCAId,qBAAqB,CAAC;IAAE,QAAQ,EAAE,UAAU,CAAC;IAAC,aAAa,EAAE,iBAAiB,CAAA;CAAE,CAAC,KACnF,OAAO,CAAC,YAAY,CAiBtB,CAAA;AAED;;;;;;;;;;;;GAYG;AACH,eAAO,MAAM,kCAAkC,QACxC,YAAY,4DAOd,qBAAqB,CAAC;IACvB,QAAQ,EAAE,MAAM,CAAA;IAChB,IAAI,EAAE,MAAM,CAAA;IACZ,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,UAAU,EAAE,MAAM,CAAA;IAClB,aAAa,EAAE,iBAAiB,CAAA;CACjC,CAAC,KACD,OAAO,CAAC,UAAU,CAiBpB,CAAA;AAED;;;;;;;;;;;;;;;GAeG;AACH,eAAO,MAAM,eAAe,QACrB,YAAY,+BAKd,qBAAqB,CAAC;IAAE,QAAQ,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CAAC,KAC3E,OAAO,CAAC,IAAI,CAgBd,CAAA;AAED;;;;;;;;;;;;;GAaG;AACH,eAAO,MAAM,cAAc,QACpB,YAAY,gBACH,qBAAqB,CAAC;IAAE,QAAQ,EAAE,MAAM,CAAA;CAAE,CAAC,KACxD,OAAO,CAAC,sBAAsB,CAUhC,CAAA"}

package/dist/api/calls/upload.js

@@ -0,0 +1,129 @@
+var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
+    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
+    return new (P || (P = Promise))(function (resolve, reject) {
+        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
+        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
+        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
+        step((generator = generator.apply(thisArg, _arguments || [])).next());
+    });
+};
+/**
+ * Initiates a file upload to the server.
+ *
+ * @param {AutoDriveApi} api - The API instance used to send requests.
+ * @param {ArgsWithoutPagination<{ mimeType?: string; filename: string; uploadOptions: FileUploadOptions | null }>} args - The arguments for the file upload.
+ * @param {string} args.mimeType - The MIME type of the file (optional).
+ * @param {string} args.filename - The name of the file to be uploaded.
+ * @param {FileUploadOptions | null} args.uploadOptions - Additional options for the file upload (optional).
+ * @returns {Promise<FileUpload>} - A promise that resolves to the file upload information.
+ * @throws {Error} - Throws an error if the upload fails.
+ */
+export const createFileUpload = (api_1, _a) => __awaiter(void 0, [api_1, _a], void 0, function* (api, { mimeType, filename, uploadOptions = {}, }) {
+    const response = yield api.sendRequest(`/uploads/file`, {
+        method: 'POST',
+        headers: new Headers({
+            'Content-Type': 'application/json',
+        }),
+    }, JSON.stringify({ mimeType, filename, uploadOptions }));
+    if (!response.ok) {
+        throw new Error(`Failed to create file upload: ${response.statusText}`);
+    }
+    return response.json();
+});
+/**
+ * Initiates a folder upload to the server.
+ *
+ * @param {AutoDriveApi} api - The API instance used to send requests.
+ * @param {ArgsWithoutPagination<{ fileTree: FolderTree; uploadOptions: FileUploadOptions }>} args - The arguments for the folder upload.
+ * @param {FolderTree} args.fileTree - The structure of the folder and its contents to be uploaded.
+ * @param {FileUploadOptions} args.uploadOptions - Additional options for the folder upload.
+ * @returns {Promise<FolderUpload>} - A promise that resolves to the folder upload information.
+ * @throws {Error} - Throws an error if the upload fails.
+ */
+export const createFolderUpload = (api_1, _a) => __awaiter(void 0, [api_1, _a], void 0, function* (api, { fileTree, uploadOptions, }) {
+    const response = yield api.sendRequest(`/uploads/folder`, {
+        method: 'POST',
+        headers: new Headers({
+            'Content-Type': 'application/json',
+        }),
+    }, JSON.stringify({ fileTree, uploadOptions }));
+    if (!response.ok) {
+        throw new Error(`Failed to create folder upload: ${response.statusText}`);
+    }
+    return response.json();
+});
+/**
+ * Creates a file upload within an existing folder upload.
+ *
+ * @param {AutoDriveApi} api - The API instance used to send requests.
+ * @param {ArgsWithoutPagination<{ uploadId: string; name: string; mimeType: string; relativeId: string; uploadOptions: FileUploadOptions }>} args - The arguments for the file upload.
+ * @param {string} args.uploadId - The ID of the folder upload to which the file will be added.
+ * @param {string} args.name - The name of the file to be uploaded.
+ * @param {string} args.mimeType - The MIME type of the file being uploaded.
+ * @param {string} args.relativeId - The relative ID of the file within the folder structure.
+ * @param {FileUploadOptions} [args.uploadOptions={}] - Additional options for the file upload.
+ * @returns {Promise<FileUpload>} - A promise that resolves to the file upload information.
+ * @throws {Error} - Throws an error if the upload fails.
+ */
+export const createFileUploadWithinFolderUpload = (api_1, _a) => __awaiter(void 0, [api_1, _a], void 0, function* (api, { uploadId, name, mimeType, relativeId, uploadOptions = {}, }) {
+    const response = yield api.sendRequest(`/uploads/folder/${uploadId}/file`, {
+        method: 'POST',
+        headers: new Headers({
+            'Content-Type': 'application/json',
+        }),
+    }, JSON.stringify({ name, mimeType, relativeId, uploadOptions }));
+    if (!response.ok) {
+        throw new Error(`Failed to create file upload within folder upload: ${response.statusText}`);
+    }
+    return response.json();
+});
+/**
+ * Uploads a chunk of a file to the server.
+ *
+ * This function allows for the uploading of a specific chunk of a file
+ * during a multi-part upload process. It sends the chunk along with its
+ * index to the server, which can be used to reconstruct the file on the
+ * server side.
+ *
+ * @param {AutoDriveApi} api - The API instance used to send requests.
+ * @param {ArgsWithoutPagination<{ uploadId: string; chunk: Buffer; index: number }>} args - The arguments for the file chunk upload.
+ * @param {string} args.uploadId - The ID of the upload session.
+ * @param {Buffer} args.chunk - The chunk of the file to be uploaded.
+ * @param {number} args.index - The index of the chunk in the overall file.
+ * @returns {Promise<void>} - A promise that resolves when the chunk is uploaded successfully.
+ * @throws {Error} - Throws an error if the upload fails.
+ */
+export const uploadFileChunk = (api_1, _a) => __awaiter(void 0, [api_1, _a], void 0, function* (api, { uploadId, chunk, index, }) {
+    const formData = new FormData();
+    formData.append('file', new Blob([chunk]));
+    formData.append('index', index.toString());
+    const response = yield api.sendRequest(`/uploads/file/${uploadId}/chunk`, {
+        method: 'POST',
+    }, formData);
+    if (!response.ok) {
+        throw new Error(`Failed to upload file chunk: ${response.statusText}`);
+    }
+});
+/**
+ * Completes a file or folder upload session on the server.
+ *
+ * This function sends a request to the server to finalize the upload
+ * process for a given upload session identified by the upload ID. It is
+ * typically called after all file chunks have been uploaded. This method
+ * can be used to complete both file and folder uploads.
+ *
+ * @param {AutoDriveApi} api - The API instance used to send requests.
+ * @param {ArgsWithoutPagination<{ uploadId: string }>} args - The arguments for completing the upload.
+ * @param {string} args.uploadId - The ID of the upload session to complete.
+ * @returns {Promise<any>} - A promise that resolves to the response from the server.
+ * @throws {Error} - Throws an error if the completion of the upload fails.
+ */
+export const completeUpload = (api_1, _a) => __awaiter(void 0, [api_1, _a], void 0, function* (api, { uploadId }) {
+    const response = yield api.sendRequest(`/uploads/${uploadId}/complete`, {
+        method: 'POST',
+    });
+    if (!response.ok) {
+        throw new Error(`Failed to complete upload: ${response.statusText}`);
+    }
+    return response.json();
+});

package/dist/api/calls/write.d.ts

@@ -0,0 +1,49 @@
+import { ArgsWithoutPagination } from '../../utils/types.js';
+import { AutoDriveApi } from '../connection.js';
+/**
+ * Shares an object with a specified public ID.
+ *
+ * This function sends a request to the server to share an object identified
+ * by its CID. The object will be shared with the provided public ID, allowing
+ * access to the object for users with that ID.
+ *
+ * @param {AutoDriveApi} api - The API instance used to send requests.
+ * @param {ArgsWithoutPagination<{ cid: string; publicId: string }>} query - The query parameters containing the CID of the object to share and the public ID to share it with.
+ * @returns {Promise<any>} - A promise that resolves to the response from the server.
+ * @throws {Error} - Throws an error if the sharing process fails.
+ */
+export declare const shareObject: (api: AutoDriveApi, query: ArgsWithoutPagination<{
+    cid: string;
+    publicId: string;
+}>) => Promise<any>;
+/**
+ * Marks an object as deleted by sending a request to the server.
+ *
+ * This function sends a request to the server to mark an object identified
+ * by its CID as deleted. This action is typically irreversible and should
+ * be used with caution.
+ *
+ * @param {AutoDriveApi} api - The API instance used to send requests.
+ * @param {ArgsWithoutPagination<{ cid: string }>} query - The query parameters containing the CID of the object to mark as deleted.
+ * @returns {Promise<void>} - A promise that resolves when the object has been marked as deleted.
+ * @throws {Error} - Throws an error if the marking process fails.
+ */
+export declare const markObjectAsDeleted: (api: AutoDriveApi, query: ArgsWithoutPagination<{
+    cid: string;
+}>) => Promise<void>;
+/**
+ * Restores an object that has been marked as deleted by sending a request to the server.
+ *
+ * This function sends a request to the server to restore an object identified
+ * by its CID. The restoration process may depend on the server's implementation
+ * and the object's current state.
+ *
+ * @param {AutoDriveApi} api - The API instance used to send requests.
+ * @param {ArgsWithoutPagination<{ cid: string }>} query - The query parameters containing the CID of the object to restore.
+ * @returns {Promise<void>} - A promise that resolves when the object has been successfully restored.
+ * @throws {Error} - Throws an error if the restoration process fails.
+ */
+export declare const restoreObject: (api: AutoDriveApi, query: ArgsWithoutPagination<{
+    cid: string;
+}>) => Promise<void>;
+//# sourceMappingURL=write.d.ts.map

package/dist/api/calls/write.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"write.d.ts","sourceRoot":"","sources":["../../../src/api/calls/write.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,qBAAqB,EAAE,MAAM,sBAAsB,CAAA;AAC5D,OAAO,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAA;AAE/C;;;;;;;;;;;GAWG;AACH,eAAO,MAAM,WAAW,QACjB,YAAY,SACV,qBAAqB,CAAC;IAAE,GAAG,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAA;CAAE,CAAC,iBAkBhE,CAAA;AAED;;;;;;;;;;;GAWG;AACH,eAAO,MAAM,mBAAmB,QACzB,YAAY,SACV,qBAAqB,CAAC;IAAE,GAAG,EAAE,MAAM,CAAA;CAAE,CAAC,KAC5C,OAAO,CAAC,IAAI,CAQd,CAAA;AAED;;;;;;;;;;;GAWG;AACH,eAAO,MAAM,aAAa,QACnB,YAAY,SACV,qBAAqB,CAAC;IAAE,GAAG,EAAE,MAAM,CAAA;CAAE,CAAC,KAC5C,OAAO,CAAC,IAAI,CAUd,CAAA"}