@mastra/s3 0.6.2-alpha.0 → 0.6.2
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +7 -61
- package/package.json +5 -5
package/README.md
CHANGED
|
@@ -31,69 +31,15 @@ const agent = new Agent({
|
|
|
31
31
|
});
|
|
32
32
|
```
|
|
33
33
|
|
|
34
|
-
|
|
35
|
-
|
|
36
|
-
When no credentials are provided, `S3Filesystem` uses the AWS SDK default credential provider chain to discover credentials from the environment automatically (environment variables, `~/.aws` config, ECS container credentials, EC2 instance profiles, etc.).
|
|
37
|
-
|
|
38
|
-
```typescript
|
|
39
|
-
import { S3Filesystem } from '@mastra/s3';
|
|
40
|
-
|
|
41
|
-
// SDK discovers credentials from the environment
|
|
42
|
-
const filesystem = new S3Filesystem({
|
|
43
|
-
bucket: 'my-bucket',
|
|
44
|
-
region: 'us-east-1',
|
|
45
|
-
});
|
|
46
|
-
```
|
|
47
|
-
|
|
48
|
-
You can also pass a credential provider function for auto-refreshing credentials, which is useful for ECS, Lambda, SSO, or AssumeRole deployments:
|
|
49
|
-
|
|
50
|
-
```typescript
|
|
51
|
-
import { S3Filesystem } from '@mastra/s3';
|
|
52
|
-
import { fromNodeProviderChain } from '@aws-sdk/credential-providers';
|
|
53
|
-
|
|
54
|
-
const filesystem = new S3Filesystem({
|
|
55
|
-
bucket: 'my-bucket',
|
|
56
|
-
region: 'us-east-1',
|
|
57
|
-
credentials: fromNodeProviderChain(),
|
|
58
|
-
});
|
|
59
|
-
```
|
|
60
|
-
|
|
61
|
-
### Cloudflare R2
|
|
62
|
-
|
|
63
|
-
```typescript
|
|
64
|
-
const workspace = new Workspace({
|
|
65
|
-
filesystem: new S3Filesystem({
|
|
66
|
-
bucket: 'my-r2-bucket',
|
|
67
|
-
region: 'auto',
|
|
68
|
-
endpoint: `https://${process.env.R2_ACCOUNT_ID}.r2.cloudflarestorage.com`,
|
|
69
|
-
accessKeyId: process.env.R2_ACCESS_KEY_ID,
|
|
70
|
-
secretAccessKey: process.env.R2_SECRET_ACCESS_KEY,
|
|
71
|
-
}),
|
|
72
|
-
});
|
|
73
|
-
```
|
|
34
|
+
## Documentation
|
|
74
35
|
|
|
75
|
-
|
|
36
|
+
- [Amazon S3 integration guide](https://mastra.ai/integrations/file-storage/amazon-s3)
|
|
37
|
+
- [Workspace documentation](https://mastra.ai/docs/mastra-platform/workspaces)
|
|
76
38
|
|
|
77
|
-
|
|
39
|
+
## Changelog
|
|
78
40
|
|
|
79
|
-
|
|
80
|
-
import { Workspace } from '@mastra/core/workspace';
|
|
81
|
-
import { S3Filesystem } from '@mastra/s3';
|
|
82
|
-
import { E2BSandbox } from '@mastra/e2b';
|
|
41
|
+
See the [package changelog](https://github.com/mastra-ai/mastra/blob/main/workspaces/s3/CHANGELOG.md) for version history and release notes.
|
|
83
42
|
|
|
84
|
-
|
|
85
|
-
mounts: {
|
|
86
|
-
'/my-bucket': new S3Filesystem({
|
|
87
|
-
bucket: 'my-bucket',
|
|
88
|
-
region: 'us-east-1',
|
|
89
|
-
accessKeyId: process.env.AWS_ACCESS_KEY_ID,
|
|
90
|
-
secretAccessKey: process.env.AWS_SECRET_ACCESS_KEY,
|
|
91
|
-
}),
|
|
92
|
-
},
|
|
93
|
-
sandbox: new E2BSandbox(),
|
|
94
|
-
});
|
|
95
|
-
```
|
|
96
|
-
|
|
97
|
-
## Documentation
|
|
43
|
+
## Support
|
|
98
44
|
|
|
99
|
-
|
|
45
|
+
We have an [open community Discord](https://discord.gg/mastra-ai). Come and say hello and let us know if you have any questions or need any help getting things running.
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@mastra/s3",
|
|
3
|
-
"version": "0.6.2
|
|
3
|
+
"version": "0.6.2",
|
|
4
4
|
"description": "S3-compatible filesystem provider for Mastra workspaces (AWS S3, Cloudflare R2, MinIO)",
|
|
5
5
|
"type": "module",
|
|
6
6
|
"main": "dist/index.js",
|
|
@@ -31,10 +31,10 @@
|
|
|
31
31
|
"tsdown": "0.22.9",
|
|
32
32
|
"typescript": "^7.0.2",
|
|
33
33
|
"vitest": "4.1.10",
|
|
34
|
-
"@internal/
|
|
35
|
-
"@internal/workspace-test-utils": "0.0.
|
|
36
|
-
"@internal/
|
|
37
|
-
"@mastra/core": "1.64.0
|
|
34
|
+
"@internal/types-builder": "0.0.105",
|
|
35
|
+
"@internal/workspace-test-utils": "0.0.74",
|
|
36
|
+
"@internal/lint": "0.0.130",
|
|
37
|
+
"@mastra/core": "1.64.0"
|
|
38
38
|
},
|
|
39
39
|
"peerDependencies": {
|
|
40
40
|
"@aws-sdk/types": "^3.0.0",
|