Skip to content

[NO ISSUE] docs: update Storage azion lib usage #1727

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Open
egermano wants to merge 3 commits into
base: main
Choose a base branch
from
+134 −67
Open

[NO ISSUE] docs: update Storage azion lib usage #1727

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
3 commits
Select commit Hold shift + click to select a range
1f4d178
docs: update Storage azion lib usage
egermano Jul 9, 2025
49bf283
fix: update `edge_access` types
egermano Jul 9, 2025
59cec0d
Merge branch 'main' into docs/update-lib-storage
GabrielAzion Jul 11, 2026
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
102 changes: 67 additions & 35 deletions src/content/docs/en/pages/devtools/azion-lib/usage/storage.mdx
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -57,7 +57,7 @@ The `createClient` method has the following **parameters** and **return value**:

| Parameter | Type | Description |
|-----------|------|-------------|
| `config` | `Partial<{ token: string; options?: OptionsParams }>` | Configuration options for the Storage client. |
| `config` | `Partial<{ token: string; options?: AzionClientOptions }>` | Configuration options for the Storage client. |

**Returns**:

Expand Down Expand Up @@ -172,7 +172,7 @@ if (data) {
| Parameter | Type | Description |
|-----------|------|-------------|
| `name` | `string` | The name of the bucket to be deleted. |
| `debug?` | `boolean` | Enables debug mode for detailed logging. |
| `options?` | [`AzionClientOptions`](#azionclientoptions) | Optional parameters for the request. |

**Returns**:

Expand Down Expand Up @@ -203,10 +203,8 @@ if (buckets) {

| Parameter | Type | Description |
|-----------|------|-------------|
| `options?` | `AzionBucketCollectionOptions` | Optional parameters for filtering and pagination. |
| `page?` | `number` | The page number for pagination. |
| `page_size?` | `number` | The number of items per page. |
| `debug?` | `boolean` | Enables debug mode for detailed logging. |
| `params?` | [`AzionBucketCollectionParams`](#azionbucketcollectionparams) | Parameters for filtering and pagination. |
| `options?` | [`AzionClientOptions`](#azionclientoptions) | Optional parameters for the request. |

**Returns**:

Expand Down Expand Up @@ -236,7 +234,7 @@ if (bucket) {
| Parameter | Type | Description |
|-----------|------|-------------|
| `name` | `string` | The name of the bucket to be retrieved. |
| `debug?` | `boolean` | Enables debug mode for detailed logging. |
| `options?` | [`AzionClientOptions`](#azionclientoptions) | Optional parameters for the request. |

**Returns**:

Expand Down Expand Up @@ -288,9 +286,9 @@ Example:
import { createObject, AzionBucketObject, AzionStorageResponse } from 'azion/storage';

const { data: newObject, error }: AzionStorageResponse<AzionBucketObject> = await createObject({
bucketName: 'my-bucket',
bucket: 'my-bucket',
key: 'new-file.txt',
file: 'File content',
content: 'File content',
});
if (newObject) {
console.log(`Object created with key: ${newObject.key}`);
Expand All @@ -304,10 +302,10 @@ if (newObject) {

| Parameter | Type | Description |
|-------------|----------|-----------------------------------------------|
| `bucketName` | `string` | The name of the bucket to create the object in. |
| `objectKey` | `string` | Key (name) of the object to be created. |
| `file` | `string` | The content of the file to be uploaded. |
| `debug?` | `boolean`| Enables debug mode for detailed logging. |
| `bucket` | `string` | The name of the bucket to create the object in.|
| `key` | `string` | Key (name) of the object to be created.|
| `content` | `string` | The content of the file to be uploaded.|

@GabrielAzion GabrielAzion Jul 13, 2026

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
| `content` | `string` | The content of the file to be uploaded.|
| `content` | [`ContentObjectStorage`](#contentobjectstorage) | The content of the file to be uploaded. Accepts `string`, `ArrayBuffer`, `ReadableStream`, or `Uint8Array`.|
| `params?` | `{ content_type?: string }` | Optional object parameters, including the content type of the file. |

| `options?` | [`AzionClientOptions`](#azionclientoptions) | Optional parameters for the request. |

**Returns**:

Expand All @@ -325,7 +323,7 @@ Example:
import { getObjectByKey, AzionBucketObject, AzionStorageResponse } from 'azion/storage';

const { data: object, error }: AzionStorageResponse<AzionBucketObject> = await getObjectByKey({
bucketName: 'my-bucket',
bucket: 'my-bucket',
key: 'file.txt',
});
if (object) {
Expand All @@ -339,9 +337,9 @@ if (object) {

| Parameter | Type | Description |
|-----------|------|-------------|
| `bucketName` | `string` | The name of the bucket containing the object. |
| `objectKey` | `string` | The key of the object to be retrieved. |
| `debug?` | `boolean` | Enables debug mode for detailed logging. |
| `bucket` | `string` | The name of the bucket containing the object. |
| `key` | `string` | The key of the object to be retrieved. |
| `options?` | [`AzionClientOptions`](#azionclientoptions) | Optional parameters for the request. |

**Returns**:

Expand All @@ -359,7 +357,7 @@ Example:
import { getObjects, AzionBucketObject, AzionStorageResponse } from 'azion/storage';

const { data: objectResult, error }: AzionStorageResponse<AzionBucketObjects> = await getObjects({
bucketName: 'my-bucket',
bucket: 'my-bucket',
});
if (objectResult) {
console.log(`Retrieved ${objectResult.count} objects from the bucket`);
Expand All @@ -372,8 +370,9 @@ if (objectResult) {

| Parameter | Type | Description |
|-----------|------|-------------|
| `bucketName` | `string` | The name of the bucket to retrieve objects from. |
| `debug?` | `boolean` | Enables debug mode for detailed logging. |
| `bucket` | `string` | The name of the bucket to retrieve objects from. |
| `params?` | [`AzionObjectCollectionParams`](#azionobjectcollectionparams) | Parameters for filtering and pagination. |
| `options?` | [`AzionClientOptions`](#azionclientoptions) | Optional parameters for the request. |

**Returns**:

Expand All @@ -391,9 +390,9 @@ Example:
import { updateObject, AzionBucketObject } from 'azion/storage';

const { data: updatedObject, error }: AzionStorageResponse<AzionBucketObject> = await updateObject({
bucketName: 'my-bucket',
bucket: 'my-bucket',
key: 'file.txt',
file: 'Updated content',
content: 'Updated content',
});
if (updatedObject) {
console.log(`Object updated: ${updatedObject.key}`);
Expand All @@ -407,10 +406,10 @@ if (updatedObject) {

| Parameter | Type | Description |
|-----------|------|-------------|
| `bucketName` | `string` | The name of the bucket containing the object. |
| `objectKey` | `string` | The key of the object to be updated. |
| `file` | `string` | The new content of the file. |
| `debug?` | `boolean` | Enables debug mode for detailed logging. |
| `bucket` | `string` | The name of the bucket containing the object. |
| `key` | `string` | The key of the object to be updated. |
| `content` | `string` | The new content of the file. |

@GabrielAzion GabrielAzion Jul 13, 2026

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
| `content` | `string` | The new content of the file. |
| `content` | [`ContentObjectStorage`](#contentobjectstorage) | The new content of the file. Accepts `string`, `ArrayBuffer`, `ReadableStream`, or `Uint8Array`. |
| `params?` | `{ content_type?: string }` | Optional object parameters, including the content type of the file. |

| `options?` | [`AzionClientOptions`](#azionclientoptions) | Optional parameters for the request. |

**Returns**:

Expand All @@ -422,13 +421,13 @@ if (updatedObject) {

Deletes an object from a specific bucket.

Example:
Example:

```typescript
import { deleteObject, AzionDeletedBucketObject, AzionStorageResponse } from 'azion/storage';

const { data: result, error }: AzionStorageResponse<AzionDeletedBucketObject> = await deleteObject({
bucketName: 'my-bucket',
bucket: 'my-bucket',
key: 'file.txt',
});
if (result) {
Expand All @@ -442,9 +441,9 @@ if (result) {

| Parameter | Type | Description |
|-----------|------|-------------|
| `bucketName` | `string` | The name of the bucket containing the object. |
| `objectKey` | `string` | The key of the object to be deleted. |
| `debug?` | `boolean` | Enables debug mode for detailed logging. |
| `bucket` | `string` | The name of the bucket containing the object. |
| `key` | `string` | The key of the object to be deleted. |
| `options?` | [`AzionClientOptions`](#azionclientoptions) | Optional parameters for the request. |

**Returns**:

Expand All @@ -458,14 +457,47 @@ if (result) {

These are the types used by the **Storage** library and its methods:

### `ClientConfig`
### AzionBucketCollectionParams

Parameters for filtering and pagination when retrieving a collection of buckets.

| Parameter | Type | Description |
|-----------|------|-------------|
| `page?` | `number` | The page number for pagination. |
| `page_size?` | `number` | The number of items per page. |

### `AzionObjectCollectionParams`

| Parameter | Type | Description |
|-----------|------|-------------|
| `max_object_count?` | `number` | The max number of items per request. |

### `EdgeAccessType`

The type of access control for the bucket.

```typescript
'read_only' | 'read_write' | 'restricted'
```

### `AzionClientOptions`

Configuration options for the Storage client.

| Parameter | Type | Description |
|-----------|------|-------------|
| `token?` | `string` | Your Azion API token. |
| `debug?` | `boolean` | Enables debug mode for detailed logging. |
| `force?` | `boolean` | Force the operation even if it might be destructive. |
| `env?` | [`AzionEnvironment`](#azionenvironment) | Environment to use (dev, stage, prod). |
| `external?` | `boolean` | Force using external REST API instead of built-in runtime API. |

### AzionEnvironment

The environment in which the client operates.

```typescript
'development' | 'staging' | 'production'
```

### `StorageClient`

Expand All @@ -474,8 +506,8 @@ An object with methods to interact with Storage.
| Method | Parameters | Return Type |
|--------|------------|--------------|
| `getBuckets` | `options?: BucketCollectionOptions` | `Promise<AzionStorageResponse<AzionBucketCollection>>` |
| `createBucket` | `name: string, edge_access: string` | `Promise<AzionStorageResponse<AzionBucket>>` |
| `updateBucket` | `name: string, edge_access: string` | `Promise<AzionStorageResponse<AzionBucket>>` |
| `createBucket` | `name: string, edge_access: EdgeAccessType` | `Promise<AzionStorageResponse<AzionBucket>>` |
| `updateBucket` | `name: string, edge_access: EdgeAccessType` | `Promise<AzionStorageResponse<AzionBucket>>` |
| `deleteBucket` | `name: string` | `Promise<AzionStorageResponse<AzionDeletedBucket>>` |
| `getBucket` | `name: string` | `Promise<AzionStorageResponse<AzionBucket>>` |

Expand Down
Loading