@twin.org/blob-storage-service 0.0.1-next.9 → 0.0.1

package/docs/reference/classes/BlobStorageEntry.md

@@ -0,0 +1,109 @@
+# Class: BlobStorageEntry
+
+Class representing entry for the blob storage.
+
+## Constructors
+
+### Constructor
+
+> **new BlobStorageEntry**(): `BlobStorageEntry`
+
+#### Returns
+
+`BlobStorageEntry`
+
+## Properties
+
+### id
+
+> **id**: `string`
+
+The id for the blob.
+
+***
+
+### dateCreated
+
+> **dateCreated**: `string`
+
+The date/time when the entry was created.
+
+***
+
+### dateModified?
+
+> `optional` **dateModified**: `string`
+
+The date/time when the entry was modified.
+
+***
+
+### blobSize
+
+> **blobSize**: `number`
+
+The length of the data in the blob.
+
+***
+
+### blobHash
+
+> **blobHash**: `string`
+
+The hash of the data in the blob.
+
+***
+
+### encodingFormat?
+
+> `optional` **encodingFormat**: `string`
+
+The mime type for the blob.
+
+***
+
+### fileExtension?
+
+> `optional` **fileExtension**: `string`
+
+The extension.
+
+***
+
+### metadata?
+
+> `optional` **metadata**: `IJsonLdNodeObject`
+
+The metadata for the blob as JSON-LD.
+
+***
+
+### isEncrypted
+
+> **isEncrypted**: `boolean`
+
+Is the entry encrypted.
+
+***
+
+### compression?
+
+> `optional` **compression**: `BlobStorageCompressionType`
+
+Is the entry compressed.
+
+***
+
+### userIdentity?
+
+> `optional` **userIdentity**: `string`
+
+The user identity that created the blob.
+
+***
+
+### nodeIdentity?
+
+> `optional` **nodeIdentity**: `string`
+
+The node identity that created the blob.

package/docs/reference/classes/BlobStorageService.md

@@ -8,33 +8,23 @@ Service for performing blob storage operations to a connector.
 
 ## Constructors
 
-### new BlobStorageService()
+### Constructor
 
-> **new BlobStorageService**(`options`?): [`BlobStorageService`](BlobStorageService.md)
+> **new BlobStorageService**(`options?`): `BlobStorageService`
 
 Create a new instance of BlobStorageService.
 
 #### Parameters
 
-• **options?**
+##### options?
 
-The dependencies for the service.
+[`IBlobStorageServiceConstructorOptions`](../interfaces/IBlobStorageServiceConstructorOptions.md)
 
-• **options.metadataEntityStorageType?**: `string`
-
-The type of the storage connector for the metadata, defaults to "blob-metadata".
-
-• **options.vaultConnectorType?**: `string`
-
-The type of the vault connector for encryption, if undefined no encryption will be performed.
-
-• **options.config?**: [`IBlobStorageServiceConfig`](../interfaces/IBlobStorageServiceConfig.md)
-
-The configuration for the service.
+The options for the service.
 
 #### Returns
 
-[`BlobStorageService`](BlobStorageService.md)
+`BlobStorageService`
 
 ## Properties
 
@@ -60,37 +50,73 @@ Runtime name for the class.
 
 ### create()
 
-> **create**(`blob`, `mimeType`?, `extension`?, `metadata`?, `namespace`?, `userIdentity`?, `nodeIdentity`?): `Promise`\<`string`\>
+> **create**(`blob`, `encodingFormat?`, `fileExtension?`, `metadata?`, `options?`, `userIdentity?`, `nodeIdentity?`): `Promise`\<`string`\>
 
 Create the blob with some metadata.
 
 #### Parameters
 
-• **blob**: `string`
+##### blob
+
+`string`
 
 The data for the blob in base64 format.
 
-• **mimeType?**: `string`
+##### encodingFormat?
+
+`string`
 
 Mime type for the blob, will be detected if left undefined.
 
-• **extension?**: `string`
+##### fileExtension?
+
+`string`
 
 Extension for the blob, will be detected if left undefined.
 
-• **metadata?**: `IJsonLdNodeObject`
+##### metadata?
+
+`IJsonLdNodeObject`
 
 Data for the custom metadata as JSON-LD.
 
-• **namespace?**: `string`
+##### options?
+
+Optional options for the creation of the blob.
+
+###### disableEncryption?
+
+`boolean`
+
+Disables encryption if enabled by default.
+
+###### overrideVaultKeyId?
+
+`string`
+
+Use a different vault key id for encryption, if not provided the default vault key id will be used.
+
+###### compress?
+
+`BlobStorageCompressionType`
+
+Optional compression type to use for the blob, defaults to no compression.*
+
+###### namespace?
+
+`string`
 
 The namespace to use for storing, defaults to component configured namespace.
 
-• **userIdentity?**: `string`
+##### userIdentity?
+
+`string`
 
 The user identity to use with storage operations.
 
-• **nodeIdentity?**: `string`
+##### nodeIdentity?
+
+`string`
 
 The node identity to use with storage operations.
 
@@ -108,49 +134,57 @@ The id of the stored blob in urn format.
 
 ### get()
 
-> **get**(`id`, `includeContent`, `userIdentity`?, `nodeIdentity`?): `Promise`\<`object`\>
+> **get**(`id`, `options?`, `userIdentity?`, `nodeIdentity?`): `Promise`\<`IBlobStorageEntry`\>
 
-Get the blob and metadata.
+Get the blob entry.
 
 #### Parameters
 
-• **id**: `string`
+##### id
+
+`string`
 
 The id of the blob to get in urn format.
 
-• **includeContent**: `boolean`
+##### options?
+
+Optional options for the retrieval of the blob.
+
+###### includeContent?
+
+`boolean`
 
 Include the content, or just get the metadata.
 
-• **userIdentity?**: `string`
+###### decompress?
 
-The user identity to use with storage operations.
+`boolean`
 
-• **nodeIdentity?**: `string`
+If the content should be decompressed, if it was compressed when stored, defaults to true.
 
-The node identity to use with storage operations.
+###### overrideVaultKeyId?
 
-#### Returns
+`string`
 
-`Promise`\<`object`\>
+Use a different vault key id for decryption, if not provided the default vault key id will be used.
 
-The metadata and data for the blob if it can be found.
+##### userIdentity?
 
-##### blob?
+`string`
 
-> `optional` **blob**: `string`
+The user identity to use with storage operations.
 
-##### mimeType?
+##### nodeIdentity?
 
-> `optional` **mimeType**: `string`
+`string`
 
-##### extension?
+The node identity to use with storage operations.
 
-> `optional` **extension**: `string`
+#### Returns
 
-##### metadata?
+`Promise`\<`IBlobStorageEntry`\>
 
-> `optional` **metadata**: `IJsonLdNodeObject`
+The entry and data for the blob if it can be found.
 
 #### Throws
 
@@ -164,33 +198,45 @@ Not found error if the blob cannot be found.
 
 ### update()
 
-> **update**(`id`, `mimeType`?, `extension`?, `metadata`?, `userIdentity`?, `nodeIdentity`?): `Promise`\<`void`\>
+> **update**(`id`, `encodingFormat?`, `fileExtension?`, `metadata?`, `userIdentity?`, `nodeIdentity?`): `Promise`\<`void`\>
 
 Update the blob with metadata.
 
 #### Parameters
 
-• **id**: `string`
+##### id
+
+`string`
 
-The id of the blob metadata to update.
+The id of the blob entry to update.
 
-• **mimeType?**: `string`
+##### encodingFormat?
+
+`string`
 
 Mime type for the blob, will be detected if left undefined.
 
-• **extension?**: `string`
+##### fileExtension?
+
+`string`
 
 Extension for the blob, will be detected if left undefined.
 
-• **metadata?**: `IJsonLdNodeObject`
+##### metadata?
+
+`IJsonLdNodeObject`
 
 Data for the custom metadata as JSON-LD.
 
-• **userIdentity?**: `string`
+##### userIdentity?
+
+`string`
 
 The user identity to use with storage operations.
 
-• **nodeIdentity?**: `string`
+##### nodeIdentity?
+
+`string`
 
 The node identity to use with storage operations.
 
@@ -212,21 +258,27 @@ Not found error if the blob cannot be found.
 
 ### remove()
 
-> **remove**(`id`, `userIdentity`?, `nodeIdentity`?): `Promise`\<`void`\>
+> **remove**(`id`, `userIdentity?`, `nodeIdentity?`): `Promise`\<`void`\>
 
 Remove the blob.
 
 #### Parameters
 
-• **id**: `string`
+##### id
+
+`string`
 
 The id of the blob to remove in urn format.
 
-• **userIdentity?**: `string`
+##### userIdentity?
+
+`string`
 
 The user identity to use with storage operations.
 
-• **nodeIdentity?**: `string`
+##### nodeIdentity?
+
+`string`
 
 The node identity to use with storage operations.
 
@@ -239,3 +291,66 @@ Nothing.
 #### Implementation of
 
 `IBlobStorageComponent.remove`
+
+***
+
+### query()
+
+> **query**(`conditions?`, `orderBy?`, `orderByDirection?`, `cursor?`, `pageSize?`, `userIdentity?`, `nodeIdentity?`): `Promise`\<`IBlobStorageEntryList`\>
+
+Query all the blob storage entries which match the conditions.
+
+#### Parameters
+
+##### conditions?
+
+`EntityCondition`\<`IBlobStorageEntry`\>
+
+The conditions to match for the entries.
+
+##### orderBy?
+
+The order for the results, defaults to created.
+
+`"dateCreated"` | `"dateModified"`
+
+##### orderByDirection?
+
+`SortDirection`
+
+The direction for the order, defaults to descending.
+
+##### cursor?
+
+`string`
+
+The cursor to request the next page of entries.
+
+##### pageSize?
+
+`number`
+
+The suggested number of entries to return in each chunk, in some scenarios can return a different amount.
+
+##### userIdentity?
+
+`string`
+
+The user identity to use with storage operations.
+
+##### nodeIdentity?
+
+`string`
+
+The node identity to use with storage operations.
+
+#### Returns
+
+`Promise`\<`IBlobStorageEntryList`\>
+
+All the entries for the storage matching the conditions,
+and a cursor which can be used to request more entities.
+
+#### Implementation of
+
+`IBlobStorageComponent.query`

package/docs/reference/functions/blobStorageCreate.md

@@ -6,15 +6,21 @@ Create a blob in storage.
 
 ## Parameters
 
-• **httpRequestContext**: `IHttpRequestContext`
+### httpRequestContext
+
+`IHttpRequestContext`
 
 The request context for the API.
 
-• **componentName**: `string`
+### componentName
+
+`string`
 
 The name of the component to use in the routes.
 
-• **request**: `IBlobStorageCreateRequest`
+### request
+
+`IBlobStorageCreateRequest`
 
 The request.
 

package/docs/reference/functions/blobStorageGet.md

@@ -6,15 +6,21 @@ Get the blob from storage.
 
 ## Parameters
 
-• **httpRequestContext**: `IHttpRequestContext`
+### httpRequestContext
+
+`IHttpRequestContext`
 
 The request context for the API.
 
-• **componentName**: `string`
+### componentName
+
+`string`
 
 The name of the component to use in the routes.
 
-• **request**: `IBlobStorageGetRequest`
+### request
+
+`IBlobStorageGetRequest`
 
 The request.
 

package/docs/reference/functions/blobStorageGetContent.md

@@ -6,15 +6,21 @@ Get the blob from storage.
 
 ## Parameters
 
-• **httpRequestContext**: `IHttpRequestContext`
+### httpRequestContext
+
+`IHttpRequestContext`
 
 The request context for the API.
 
-• **componentName**: `string`
+### componentName
+
+`string`
 
 The name of the component to use in the routes.
 
-• **request**: `IBlobStorageGetContentRequest`
+### request
+
+`IBlobStorageGetContentRequest`
 
 The request.
 

package/docs/reference/functions/blobStorageList.md

@@ -0,0 +1,31 @@
+# Function: blobStorageList()
+
+> **blobStorageList**(`httpRequestContext`, `componentName`, `request`): `Promise`\<`IBlobStorageListResponse`\>
+
+List the entries from blob storage.
+
+## Parameters
+
+### httpRequestContext
+
+`IHttpRequestContext`
+
+The request context for the API.
+
+### componentName
+
+`string`
+
+The name of the component to use in the routes.
+
+### request
+
+`IBlobStorageListRequest`
+
+The request.
+
+## Returns
+
+`Promise`\<`IBlobStorageListResponse`\>
+
+The response object with additional http response properties.

package/docs/reference/functions/blobStorageRemove.md

@@ -6,15 +6,21 @@ Remove the blob from storage.
 
 ## Parameters
 
-• **httpRequestContext**: `IHttpRequestContext`
+### httpRequestContext
+
+`IHttpRequestContext`
 
 The request context for the API.
 
-• **componentName**: `string`
+### componentName
+
+`string`
 
 The name of the component to use in the routes.
 
-• **request**: `IBlobStorageRemoveRequest`
+### request
+
+`IBlobStorageRemoveRequest`
 
 The request.
 

package/docs/reference/functions/blobStorageUpdate.md

@@ -6,15 +6,21 @@ Update the blob storage metadata.
 
 ## Parameters
 
-• **httpRequestContext**: `IHttpRequestContext`
+### httpRequestContext
+
+`IHttpRequestContext`
 
 The request context for the API.
 
-• **componentName**: `string`
+### componentName
+
+`string`
 
 The name of the component to use in the routes.
 
-• **request**: `IBlobStorageUpdateRequest`
+### request
+
+`IBlobStorageUpdateRequest`
 
 The request.
 

package/docs/reference/functions/generateRestRoutesBlobStorage.md

@@ -1,33 +1,41 @@
 # Function: generateRestRoutesBlobStorage()
 
-> **generateRestRoutesBlobStorage**(`baseRouteName`, `componentName`, `options`?): `IRestRoute`[]
+> **generateRestRoutesBlobStorage**(`baseRouteName`, `componentName`, `options?`): `IRestRoute`\<`any`, `any`\>[]
 
 The REST routes for blob storage.
 
 ## Parameters
 
-• **baseRouteName**: `string`
+### baseRouteName
+
+`string`
 
 Prefix to prepend to the paths.
 
-• **componentName**: `string`
+### componentName
+
+`string`
 
 The name of the component to use in the routes stored in the ComponentFactory.
 
-• **options?**
+### options?
 
 Additional options for the routes.
 
-• **options.typeName?**: `string`
+#### typeName?
+
+`string`
 
 Optional type name to use in the routes, defaults to Blob Storage.
 
-• **options.tagName?**: `string`
+#### tagName?
+
+`string`
 
 Optional name to use in OpenAPI spec for tag.
 
 ## Returns
 
-`IRestRoute`[]
+`IRestRoute`\<`any`, `any`\>[]
 
 The generated routes.

package/docs/reference/index.md

@@ -3,11 +3,12 @@
 ## Classes
 
 - [BlobStorageService](classes/BlobStorageService.md)
-- [BlobMetadata](classes/BlobMetadata.md)
+- [BlobStorageEntry](classes/BlobStorageEntry.md)
 
 ## Interfaces
 
 - [IBlobStorageServiceConfig](interfaces/IBlobStorageServiceConfig.md)
+- [IBlobStorageServiceConstructorOptions](interfaces/IBlobStorageServiceConstructorOptions.md)
 
 ## Variables
 
@@ -22,4 +23,5 @@
 - [blobStorageGetContent](functions/blobStorageGetContent.md)
 - [blobStorageUpdate](functions/blobStorageUpdate.md)
 - [blobStorageRemove](functions/blobStorageRemove.md)
+- [blobStorageList](functions/blobStorageList.md)
 - [initSchema](functions/initSchema.md)

package/docs/reference/interfaces/IBlobStorageServiceConfig.md

@@ -8,13 +8,7 @@ Configuration for the blob storage service.
 
 > `optional` **vaultKeyId**: `string`
 
-The name of the vault key to use for encryption if the service has a vault connector configured.
-
-#### Default
-
-```ts
-blob-storage.
-```
+The name of the vault key to use for encryption, if not configured no encryption will happen.
 
 ***