@gofynd/fdk-client-javascript 1.0.3 → 1.1.0

package/documentation/application/FILESTORAGE.md

@@ -1,442 +0,0 @@
-
-
-
-
-
-##### [Back to Application docs](./README.md)
-
-## FileStorage Methods
-File Storage
-
-* [upload](#upload)
-
-* [completeUpload](#completeupload)
-* [signUrls](#signurls)
-* [startUpload](#startupload)
-
-
-
-## Methods with example and description
-
-
-
-
-### upload
-method which internally calls `startUpload` and `completeUpload` method to handle the whole file upload flow.
-
-
-```javascript
-// Promise
-const promise = fileStorage.upload({
-    data,
-    file_name,
-    content_type,
-    namespace,
-    size,
-    tags,
-});
-
-// Async/Await
-const data = await fileStorage.upload({
-    data,
-    file_name,
-    content_type,
-    namespace,
-    size,
-    tags,
-});
-```
-| Argument  |  Type  | Required | Description |
-| --------- | -----  | -------- | ----------- | 
-| data | file | yes | File which needs to be uploaded |
-| file_name | string | yes | Name of the file |
-| content_type | string | yes | type of file |
-| namespace | string | yes | Name of the bucket created for storing objects |
-| size | number | yes | File size |
-| tags | [string] | yes |  |
-
-
-Use this API to perform the upload of an arbitrarily sized buffer or blob.
-
-
-
-*Returned Response:*
-
-[CompleteResponse](#CompleteResponse)
-
-
-
-<details>
-<summary><i>&nbsp; Example:</i></summary>
-
-```json
-{
-    "file_name":"logo.png",
-    "file_path":"/path/to/file/logo.png",
-    "success":true,
-    "namespace":"namespace",
-    "content_type":"image/png",
-    "size":1024,
-    "operation":"putObject",
-    "tags":[],
-    "cdn":{
-        "url":"https://cdn.pixelbin.io/v2/logo.png",
-        "absolute_url":"https://cdn.pixelbin.io/v2/logo.png",
-        "relative_url":"logo.png"
-    },
-    "_id":"63dbbxxxxxxxxxxxxdecc69f",
-    "created_by":{
-        "username":"username_gofynd_com"
-    },
-    "created_on":"2023-01-01T12:00:00.000Z",
-    "modified_on":"2023-01-01T00:00:00.000Z"
-}
-```
-</details>
-
----
-
-
-
-
-
-### completeUpload
-Completes the upload process. After successfully uploading a file, call this API to finish the upload process.
-
-
-
-```javascript
-// Promise
-const promise = fileStorage.completeUpload({  namespace : value,
- body : value });
-
-// Async/Await
-const data = await fileStorage.completeUpload({  namespace : value,
- body : value });
-```
-
-
-
-
-
-| Argument  |  Type  | Required | Description |
-| --------- | -----  | -------- | ----------- | 
-| namespace | string | yes | Name of the bucket created for storing objects. |  
-| body | [StartResponse](#StartResponse) | yes | Request body |
-
-
-Use this API to perform the third step of uploading (i.e. **Complete**) an arbitrarily sized buffer or blob.
-
-The three major steps are:
-* Start
-* Upload
-* Complete
-
-### Start
-Initiates the assets upload using `startUpload`.
-It returns a storage link in response.
-
-### Upload
-Use the storage link to upload a file (Buffer or Blob) to the File Storage.
-Make a `PUT` request on storage link received from `startUpload` API with the file (Buffer or Blob) in the request body.
-
-### Complete
-After successfully upload, call the `completeUpload` API to finish the upload process.
-This operation will return the URL of the uploaded file.
-
-
-*Returned Response:*
-
-
-
-
-[CompleteResponse](#CompleteResponse)
-
-Success
-
-
-
-
-<details>
-<summary><i>&nbsp; Example:</i></summary>
-
-```json
-
-```
-</details>
-
-
-
-
-
-
-
-
-
----
-
-
-### signUrls
-Explain here
-
-
-
-```javascript
-// Promise
-const promise = fileStorage.signUrls({  body : value });
-
-// Async/Await
-const data = await fileStorage.signUrls({  body : value });
-```
-
-
-
-
-
-| Argument  |  Type  | Required | Description |
-| --------- | -----  | -------- | ----------- |
-| body | [SignUrlRequest](#SignUrlRequest) | yes | Request body |
-
-
-Describe here
-
-*Returned Response:*
-
-
-
-
-[SignUrlResponse](#SignUrlResponse)
-
-Success
-
-
-
-
-<details>
-<summary><i>&nbsp; Example:</i></summary>
-
-```json
-
-```
-</details>
-
-
-
-
-
-
-
-
-
----
-
-
-### startUpload
-Initiates an upload and returns a storage link that is valid for 30 minutes. You can use the storage link to make subsequent upload request with file buffer or blob.
-
-
-
-```javascript
-// Promise
-const promise = fileStorage.startUpload({  namespace : value,
- body : value });
-
-// Async/Await
-const data = await fileStorage.startUpload({  namespace : value,
- body : value });
-```
-
-
-
-
-
-| Argument  |  Type  | Required | Description |
-| --------- | -----  | -------- | ----------- | 
-| namespace | string | yes | Name of the bucket created for storing objects. |  
-| body | [StartRequest](#StartRequest) | yes | Request body |
-
-
-Use this API to perform the first step of uploading (i.e. **Start**) an arbitrarily sized buffer or blob.
-
-The three major steps are:
-* Start
-* Upload
-* Complete
-
-### Start
-Initiates the assets upload using `startUpload`.
-It returns a storage link in response.
-
-### Upload
-Use the storage link to upload a file (Buffer or Blob) to the File Storage.
-Make a `PUT` request on storage link received from `startUpload` API with the file (Buffer or Blob) in the request body.
-
-### Complete
-After successfully upload, call the `completeUpload` API to finish the upload process.
-This operation will return the URL of the uploaded file.
-
-
-*Returned Response:*
-
-
-
-
-[StartResponse](#StartResponse)
-
-Success. Next, call the `completeUpload` API and pass the response payload of this API to finish the upload process.
-
-
-
-
-<details>
-<summary><i>&nbsp; Example:</i></summary>
-
-```json
-
-```
-</details>
-
-
-
-
-
-
-
-
-
----
-
-
-
-### Schemas
-
-
-#### [BrowseResponse](#BrowseResponse)
-
- | Properties | Type | Nullable | Description |
- | ---------- | ---- | -------- | ----------- || items | [[DbRecord](#DbRecord)] |  yes  |  || page | [Page](#Page) |  yes  |  |
-
----
-
-#### [BulkRequest](#BulkRequest)
-
- | Properties | Type | Nullable | Description |
- | ---------- | ---- | -------- | ----------- || configuration | [ReqConfiguration](#ReqConfiguration) |  no  |  || destination | [Destination](#Destination) |  yes  |  || urls | [string] |  yes  |  |
-
----
-
-#### [BulkUploadResponse](#BulkUploadResponse)
-
- | Properties | Type | Nullable | Description |
- | ---------- | ---- | -------- | ----------- || task | [CopyFileTask](#CopyFileTask) |  yes  |  || tracking_url | string |  yes  |  |
-
----
-
-#### [CDN](#CDN)
-
- | Properties | Type | Nullable | Description |
- | ---------- | ---- | -------- | ----------- || absolute_url | string |  no  |  || relative_url | string |  no  |  || url | string |  yes  |  |
-
----
-
-#### [CompleteResponse](#CompleteResponse)
-
- | Properties | Type | Nullable | Description |
- | ---------- | ---- | -------- | ----------- || _id | string |  yes  |  || cdn | [CDN](#CDN) |  yes  |  || content_type | string |  yes  |  || created_on | string |  yes  |  || file_name | string |  yes  |  || file_path | string |  yes  |  || modified_on | string |  yes  |  || namespace | string |  yes  |  || operation | string |  yes  |  || size | number |  yes  |  || success | boolean |  yes  |  || tags | [string] |  no  |  || upload | [Upload](#Upload) |  yes  |  |
-
----
-
-#### [CopyFileTask](#CopyFileTask)
-
- | Properties | Type | Nullable | Description |
- | ---------- | ---- | -------- | ----------- || attempts_made | number |  yes  |  || data | [BulkRequest](#BulkRequest) |  yes  |  || delay | number |  yes  |  || finished_on | number |  yes  |  || id | string |  yes  |  || name | string |  yes  |  || opts | [Opts](#Opts) |  yes  |  || processed_on | number |  yes  |  || progress | number |  yes  |  || stacktrace | [string] |  no  |  || timestamp | number |  yes  |  |
-
----
-
-#### [DbRecord](#DbRecord)
-
- | Properties | Type | Nullable | Description |
- | ---------- | ---- | -------- | ----------- || _id | string |  yes  |  || cdn | [CDN](#CDN) |  yes  |  || content_type | string |  yes  |  || created_on | string |  yes  |  || file_name | string |  yes  |  || file_path | string |  yes  |  || modified_on | string |  yes  |  || namespace | string |  yes  |  || operation | string |  no  |  || success | boolean |  yes  |  || tags | [string] |  yes  |  || upload | [Upload](#Upload) |  yes  |  |
-
----
-
-#### [Destination](#Destination)
-
- | Properties | Type | Nullable | Description |
- | ---------- | ---- | -------- | ----------- || basepath | string |  no  |  || namespace | string |  yes  |  || rewrite | string |  yes  |  |
-
----
-
-#### [FailedResponse](#FailedResponse)
-
- | Properties | Type | Nullable | Description |
- | ---------- | ---- | -------- | ----------- || message | string |  yes  |  |
-
----
-
-#### [Opts](#Opts)
-
- | Properties | Type | Nullable | Description |
- | ---------- | ---- | -------- | ----------- || attempts | number |  no  |  || delay | number |  no  |  || timestamp | number |  no  |  |
-
----
-
-#### [Page](#Page)
-
- | Properties | Type | Nullable | Description |
- | ---------- | ---- | -------- | ----------- || current | number |  no  |  || has_next | boolean |  no  |  || has_previous | boolean |  no  |  || item_total | number |  no  |  || next_id | string |  no  |  || size | number |  no  |  || type | number |  yes  |  |
-
----
-
-#### [ReqConfiguration](#ReqConfiguration)
-
- | Properties | Type | Nullable | Description |
- | ---------- | ---- | -------- | ----------- || concurrency | number |  no  |  |
-
----
-
-#### [SignUrlRequest](#SignUrlRequest)
-
- | Properties | Type | Nullable | Description |
- | ---------- | ---- | -------- | ----------- || expiry | number |  yes  |  || urls | [string] |  yes  |  |
-
----
-
-#### [SignUrlResponse](#SignUrlResponse)
-
- | Properties | Type | Nullable | Description |
- | ---------- | ---- | -------- | ----------- || urls | [[Urls](#Urls)] |  yes  |  |
-
----
-
-#### [StartRequest](#StartRequest)
-
- | Properties | Type | Nullable | Description |
- | ---------- | ---- | -------- | ----------- || content_type | string |  yes  |  || file_name | string |  yes  |  || params | string |  no  |  || size | number |  yes  |  || tags | [string] |  no  |  |
-
----
-
-#### [StartResponse](#StartResponse)
-
- | Properties | Type | Nullable | Description |
- | ---------- | ---- | -------- | ----------- || cdn | [CDN](#CDN) |  yes  |  || content_type | string |  yes  |  || file_name | string |  yes  |  || file_path | string |  yes  |  || method | string |  no  |  || namespace | string |  yes  |  || operation | string |  yes  |  || size | number |  yes  |  || tags | [string] |  no  |  || upload | [Upload](#Upload) |  yes  |  |
-
----
-
-#### [Upload](#Upload)
-
- | Properties | Type | Nullable | Description |
- | ---------- | ---- | -------- | ----------- || expiry | number |  yes  |  || url | string |  yes  |  |
-
----
-
-#### [Urls](#Urls)
-
- | Properties | Type | Nullable | Description |
- | ---------- | ---- | -------- | ----------- || expiry | number |  yes  |  || signed_url | string |  yes  |  || url | string |  yes  |  |
-
----
-
-
-
-