@mastra/files-sdk 0.0.0

package/CHANGELOG.md

@@ -0,0 +1 @@
+# @mastra/files-sdk

package/LICENSE.md

@@ -0,0 +1,30 @@
+Portions of this software are licensed as follows:
+
+- All content that resides under any directory named "ee/" within this
+  repository, including but not limited to:
+  - `packages/core/src/auth/ee/`
+  - `packages/server/src/server/auth/ee/`
+    is licensed under the license defined in `ee/LICENSE`.
+
+- All third-party components incorporated into the Mastra Software are
+  licensed under the original license provided by the owner of the
+  applicable component.
+
+- Content outside of the above-mentioned directories or restrictions is
+  available under the "Apache License 2.0" as defined below.
+
+# Apache License 2.0
+
+Copyright (c) 2025 Kepler Software, Inc.
+
+Licensed under the Apache License, Version 2.0 (the "License");
+you may not use this file except in compliance with the License.
+You may obtain a copy of the License at
+
+    http://www.apache.org/licenses/LICENSE-2.0
+
+Unless required by applicable law or agreed to in writing, software
+distributed under the License is distributed on an "AS IS" BASIS,
+WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+See the License for the specific language governing permissions and
+limitations under the License.

package/README.md

@@ -0,0 +1,107 @@
+# @mastra/files-sdk
+
+Unified storage filesystem provider for Mastra workspaces, powered by [FilesSDK](https://files-sdk.dev). Works with any FilesSDK adapter — S3, Cloudflare R2, Google Cloud Storage, Azure Blob, Vercel Blob, local filesystem, and more.
+
+## Installation
+
+```bash
+npm install @mastra/files-sdk files-sdk
+```
+
+Then install the FilesSDK adapter for your storage backend:
+
+```bash
+# AWS S3 / R2 / MinIO / DigitalOcean Spaces
+npm install @aws-sdk/client-s3 @aws-sdk/s3-presigned-post @aws-sdk/s3-request-presigner
+
+# Google Cloud Storage
+npm install @google-cloud/storage google-auth-library
+
+# Azure Blob Storage
+npm install @azure/storage-blob @azure/core-auth @azure/identity
+
+# Vercel Blob
+npm install @vercel/blob
+
+# Local filesystem (dev/test)
+# No extra dependencies needed
+```
+
+## Usage
+
+```typescript
+import { Agent } from '@mastra/core/agent';
+import { Workspace } from '@mastra/core/workspace';
+import { FilesSDKFilesystem } from '@mastra/files-sdk';
+import { Files } from 'files-sdk';
+import { s3 } from 'files-sdk/s3';
+
+const files = new Files({
+  adapter: s3({
+    bucket: 'my-bucket',
+    region: 'us-east-1',
+  }),
+});
+
+const workspace = new Workspace({
+  filesystem: new FilesSDKFilesystem({ files }),
+});
+
+const agent = new Agent({
+  name: 'my-agent',
+  model: 'anthropic/claude-opus-4-5',
+  workspace,
+});
+```
+
+### Switching adapters
+
+The power of FilesSDK is that you can swap storage backends by changing only the adapter import:
+
+```typescript
+import { Files } from 'files-sdk';
+import { r2 } from 'files-sdk/r2';
+
+const files = new Files({
+  adapter: r2({
+    accountId: process.env.R2_ACCOUNT_ID!,
+    accessKeyId: process.env.R2_ACCESS_KEY_ID!,
+    secretAccessKey: process.env.R2_SECRET_ACCESS_KEY!,
+    bucket: 'my-bucket',
+  }),
+});
+
+const workspace = new Workspace({
+  filesystem: new FilesSDKFilesystem({ files }),
+});
+```
+
+### Local filesystem for development
+
+```typescript
+import { Files } from 'files-sdk';
+import { fs } from 'files-sdk/fs';
+
+const files = new Files({
+  adapter: fs({ root: './.uploads' }),
+});
+
+const workspace = new Workspace({
+  filesystem: new FilesSDKFilesystem({ files }),
+});
+```
+
+## Options
+
+| Option        | Type      | Required | Description                           |
+| ------------- | --------- | -------- | ------------------------------------- |
+| `files`       | `Files`   | Yes      | Pre-configured FilesSDK instance      |
+| `id`          | `string`  | No       | Unique filesystem ID (auto-generated) |
+| `displayName` | `string`  | No       | Human-friendly name for UI            |
+| `icon`        | `string`  | No       | Icon identifier                       |
+| `description` | `string`  | No       | Description for UI                    |
+| `readOnly`    | `boolean` | No       | Mount as read-only                    |
+
+## License
+
+Apache-2.0

package/package.json

@@ -0,0 +1,64 @@
+{
+  "name": "@mastra/files-sdk",
+  "version": "0.0.0",
+  "description": "FilesSDK filesystem provider for Mastra workspaces — unified storage across S3, R2, GCS, Azure, Vercel Blob, and more",
+  "type": "module",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "exports": {
+    ".": {
+      "import": {
+        "types": "./dist/index.d.ts",
+        "default": "./dist/index.js"
+      },
+      "require": {
+        "types": "./dist/index.d.ts",
+        "default": "./dist/index.cjs"
+      }
+    },
+    "./package.json": "./package.json"
+  },
+  "license": "Apache-2.0",
+  "dependencies": {
+    "files-sdk": "^1.5.0"
+  },
+  "devDependencies": {
+    "@types/node": "22.19.15",
+    "eslint": "^10.2.1",
+    "tsup": "^8.5.1",
+    "typescript": "^6.0.3",
+    "vitest": "4.1.5",
+    "@internal/lint": "0.0.97",
+    "@internal/types-builder": "0.0.72",
+    "@mastra/core": "1.37.0-alpha.7",
+    "@internal/workspace-test-utils": "0.0.41"
+  },
+  "peerDependencies": {
+    "@mastra/core": ">=1.4.0-0 <2.0.0-0"
+  },
+  "files": [
+    "dist",
+    "CHANGELOG.md"
+  ],
+  "homepage": "https://mastra.ai",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/mastra-ai/mastra.git",
+    "directory": "workspaces/files-sdk"
+  },
+  "bugs": {
+    "url": "https://github.com/mastra-ai/mastra/issues"
+  },
+  "engines": {
+    "node": ">=22.13.0"
+  },
+  "scripts": {
+    "build": "tsup --silent --config tsup.config.ts",
+    "build:lib": "pnpm build",
+    "build:watch": "pnpm build --watch",
+    "test:unit": "vitest run --exclude '**/*.integration.test.ts'",
+    "test:integration": "vitest run ./src/**/*.integration.test.ts",
+    "test:watch": "vitest watch",
+    "lint": "eslint ."
+  }
+}