@mastra/deployer 1.64.0-alpha.6 → 1.64.0-alpha.8
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 +6 -123
- package/dist/docs/SKILL.md +1 -1
- package/dist/docs/assets/SOURCE_MAP.json +1 -1
- package/package.json +8 -8
package/README.md
CHANGED
|
@@ -8,15 +8,6 @@ Core deployment infrastructure for Mastra applications, handling build, packagin
|
|
|
8
8
|
npm install @mastra/deployer
|
|
9
9
|
```
|
|
10
10
|
|
|
11
|
-
## Overview
|
|
12
|
-
|
|
13
|
-
The `@mastra/deployer` package provides the foundational deployment infrastructure for Mastra applications. It handles:
|
|
14
|
-
|
|
15
|
-
- Project building and bundling
|
|
16
|
-
- Dependency management
|
|
17
|
-
- Environment configuration
|
|
18
|
-
- Development and production deployments
|
|
19
|
-
|
|
20
11
|
## Usage
|
|
21
12
|
|
|
22
13
|
```typescript
|
|
@@ -38,122 +29,14 @@ await deployer.writePackageJson();
|
|
|
38
29
|
const { mastra } = await deployer.getMastra();
|
|
39
30
|
```
|
|
40
31
|
|
|
41
|
-
##
|
|
42
|
-
|
|
43
|
-
### Required Parameters
|
|
44
|
-
|
|
45
|
-
- `dir`: Project directory path
|
|
46
|
-
- `type`: Deployment type ('Deploy' or 'Dev')
|
|
47
|
-
|
|
48
|
-
## Features
|
|
49
|
-
|
|
50
|
-
### Project Structure Management
|
|
51
|
-
|
|
52
|
-
- Creates and manages `.mastra` directory
|
|
53
|
-
- Handles package.json generation and updates
|
|
54
|
-
- Manages project dependencies
|
|
55
|
-
|
|
56
|
-
### Dependency Management
|
|
57
|
-
|
|
58
|
-
- Automatic dependency installation
|
|
59
|
-
- Workspace dependency resolution
|
|
60
|
-
- Version management for @mastra packages
|
|
61
|
-
|
|
62
|
-
### Environment Handling
|
|
63
|
-
|
|
64
|
-
- Support for multiple environment files:
|
|
65
|
-
- `.env`
|
|
66
|
-
- `.env.development`
|
|
67
|
-
- `.env.local`
|
|
68
|
-
- Environment variable validation and processing
|
|
69
|
-
|
|
70
|
-
### Build Process
|
|
71
|
-
|
|
72
|
-
- Project bundling
|
|
73
|
-
- Asset management
|
|
74
|
-
- Source code transformation
|
|
75
|
-
|
|
76
|
-
### Development Support
|
|
77
|
-
|
|
78
|
-
- Development server configuration
|
|
79
|
-
- Hot reloading capabilities
|
|
80
|
-
- Debug logging
|
|
81
|
-
|
|
82
|
-
## Project Structure
|
|
83
|
-
|
|
84
|
-
The deployer creates and manages the following structure:
|
|
85
|
-
|
|
86
|
-
```
|
|
87
|
-
your-project/
|
|
88
|
-
├── .mastra/
|
|
89
|
-
│ ├── package.json
|
|
90
|
-
│ ├── mastra.mjs
|
|
91
|
-
│ └── index.mjs
|
|
92
|
-
├── .env
|
|
93
|
-
├── .env.development
|
|
94
|
-
├── .env.local
|
|
95
|
-
└── package.json
|
|
96
|
-
```
|
|
97
|
-
|
|
98
|
-
## Package.json Management
|
|
99
|
-
|
|
100
|
-
The deployer automatically manages dependencies in the `.mastra/package.json`:
|
|
101
|
-
|
|
102
|
-
```json
|
|
103
|
-
{
|
|
104
|
-
"name": "server",
|
|
105
|
-
"version": "1.0.0",
|
|
106
|
-
"type": "module",
|
|
107
|
-
"dependencies": {
|
|
108
|
-
"@mastra/loggers": "latest",
|
|
109
|
-
"hono": "4.6.17",
|
|
110
|
-
"@hono/node-server": "^1.13.7",
|
|
111
|
-
"superjson": "^2.2.2",
|
|
112
|
-
"zod-to-json-schema": "^3.24.1"
|
|
113
|
-
}
|
|
114
|
-
}
|
|
115
|
-
```
|
|
116
|
-
|
|
117
|
-
## Methods
|
|
118
|
-
|
|
119
|
-
### `install()`
|
|
120
|
-
|
|
121
|
-
Installs and updates project dependencies.
|
|
122
|
-
|
|
123
|
-
### `writePackageJson()`
|
|
124
|
-
|
|
125
|
-
Generates or updates the package.json in the .mastra directory.
|
|
126
|
-
|
|
127
|
-
### `getMastra()`
|
|
128
|
-
|
|
129
|
-
Returns the Mastra instance for the project.
|
|
130
|
-
|
|
131
|
-
### `getMastraPath()`
|
|
132
|
-
|
|
133
|
-
Returns the path to the .mastra directory.
|
|
134
|
-
|
|
135
|
-
## Error Handling
|
|
136
|
-
|
|
137
|
-
The deployer includes comprehensive error handling for:
|
|
138
|
-
|
|
139
|
-
- Dependency installation failures
|
|
140
|
-
- File system operations
|
|
141
|
-
- Environment configuration issues
|
|
142
|
-
- Build process errors
|
|
32
|
+
## Documentation
|
|
143
33
|
|
|
144
|
-
|
|
34
|
+
- [@mastra/deployer documentation](https://mastra.ai/reference/deployer)
|
|
145
35
|
|
|
146
|
-
|
|
36
|
+
## Changelog
|
|
147
37
|
|
|
148
|
-
-
|
|
149
|
-
- Installation progress
|
|
150
|
-
- Build status
|
|
151
|
-
- Error reporting
|
|
38
|
+
See the [package changelog](https://github.com/mastra-ai/mastra/blob/main/packages/deployer/CHANGELOG.md) for version history and release notes.
|
|
152
39
|
|
|
153
|
-
##
|
|
40
|
+
## Support
|
|
154
41
|
|
|
155
|
-
|
|
156
|
-
- `@mastra/loggers`: Logging infrastructure
|
|
157
|
-
- Deployer implementations:
|
|
158
|
-
- `@mastra/deployer-cloudflare`
|
|
159
|
-
- Other platform-specific deployers
|
|
42
|
+
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/dist/docs/SKILL.md
CHANGED
|
@@ -3,7 +3,7 @@ name: mastra-deployer
|
|
|
3
3
|
description: Documentation for @mastra/deployer. Use when working with @mastra/deployer APIs, configuration, or implementation.
|
|
4
4
|
metadata:
|
|
5
5
|
package: "@mastra/deployer"
|
|
6
|
-
version: "1.64.0-alpha.
|
|
6
|
+
version: "1.64.0-alpha.8"
|
|
7
7
|
---
|
|
8
8
|
|
|
9
9
|
## When to use
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@mastra/deployer",
|
|
3
|
-
"version": "1.64.0-alpha.
|
|
3
|
+
"version": "1.64.0-alpha.8",
|
|
4
4
|
"description": "",
|
|
5
5
|
"type": "module",
|
|
6
6
|
"files": [
|
|
@@ -111,7 +111,7 @@
|
|
|
111
111
|
"typescript-paths": "^1.5.2",
|
|
112
112
|
"ws": "^8.21.0",
|
|
113
113
|
"yaml": "^2.9.0",
|
|
114
|
-
"@mastra/server": "1.64.0-alpha.
|
|
114
|
+
"@mastra/server": "1.64.0-alpha.8"
|
|
115
115
|
},
|
|
116
116
|
"devDependencies": {
|
|
117
117
|
"@hono/node-server": "^2.0.0",
|
|
@@ -131,13 +131,13 @@
|
|
|
131
131
|
"typescript": "^6.0.3",
|
|
132
132
|
"vitest": "4.1.10",
|
|
133
133
|
"zod": "^4.4.3",
|
|
134
|
-
"@internal/types-builder": "0.0.104",
|
|
135
134
|
"@internal/lint": "0.0.129",
|
|
136
|
-
"@
|
|
137
|
-
"@mastra/
|
|
138
|
-
"@mastra/
|
|
139
|
-
"@mastra/
|
|
140
|
-
"@mastra/
|
|
135
|
+
"@internal/types-builder": "0.0.104",
|
|
136
|
+
"@mastra/agent-browser": "0.5.2-alpha.1",
|
|
137
|
+
"@mastra/core": "1.64.0-alpha.8",
|
|
138
|
+
"@mastra/mcp": "^1.17.3-alpha.2",
|
|
139
|
+
"@mastra/hono": "1.7.6-alpha.8",
|
|
140
|
+
"@mastra/server": "1.64.0-alpha.8"
|
|
141
141
|
},
|
|
142
142
|
"peerDependencies": {
|
|
143
143
|
"@mastra/core": ">=1.50.0-0 <2.0.0-0"
|