@pwrdrvr/microapps-publish 1.1.2 → 1.2.0-beta.4

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.
Files changed (4) hide show
  1. package/LICENSE +1 -1
  2. package/README.md +5 -239
  3. package/bin/run +0 -0
  4. package/package.json +8 -8
package/LICENSE CHANGED
@@ -18,4 +18,4 @@ FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
18
18
  AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
19
19
  LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
20
20
  OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
21
- SOFTWARE.
21
+ SOFTWARE.
package/README.md CHANGED
@@ -1,241 +1,7 @@
1
- # Overview
1
+ # microapps-publish
2
2
 
3
- `pwrdrvr` is the CLI used to deploy new MicroApps and new versions for existing MicroApps using the [MicroApps framework](https://github.com/pwrdrvr/microapps-core/).
3
+ `@pwrdrvr/microapps-publish` is a convenience package that exposes the
4
+ `microapps-publish` binary and delegates to `pwrdrvr`.
4
5
 
5
- # Table of Contents <!-- omit in toc -->
6
-
7
- - [Overview](#overview)
8
- - [Video Preview of Deploying an App](#video-preview-of-deploying-an-app)
9
- - [Installation](#installation)
10
- - [Usage](#usage)
11
- - [Command - help](#command---help)
12
- - [Command - preflight](#command---preflight)
13
- - [Command - publish](#command---publish)
14
- - [Command - publish-static](#command---publish-static)
15
- - [Command - nextjs-version](#command---nextjs-version)
16
- - [Command - nextjs-version-restore](#command---nextjs-version-restore)
17
- - [Command - delete](#command---delete)
18
-
19
- # Video Preview of Deploying an App
20
-
21
- ![Video Preview of Deploying an App](https://raw.githubusercontent.com/pwrdrvr/microapps-core/main/assets/videos/pwrdrvr-demo-deploy.gif)
22
-
23
- # Installation
24
-
25
- `npm i -g pwrdrvr`
26
-
27
- # Usage
28
-
29
- ## Command - help
30
-
31
- `npx pwrdrvr help`
32
-
33
- ```
34
- Publish tool for deploying apps and updates
35
-
36
- VERSION
37
- pwrdrvr/0.0.0 darwin-arm64 node-v18.12.1
38
-
39
- USAGE
40
- $ pwrdrvr [COMMAND]
41
-
42
- COMMANDS
43
- delete Delete app/version
44
- help display help for pwrdrvr
45
- nextjs-version Apply version to next.config.js overtop of 0.0.0 placeholder
46
- nextjs-version-restore Restore next.config.js
47
- preflight Check if app/version are available
48
- publish Publish arbitrary framework app - deploy static assets to S3, alias the $LATEST Lambda
49
- function, and add integration/route to API Gateway.
50
- publish-static Publish arbitrary framework static app - deploy static assets to S3 only.
51
- ```
52
-
53
- ## Command - preflight
54
-
55
- `npx pwrdrvr preflight help`
56
-
57
- ```
58
- Check if app/version are available
59
-
60
- USAGE
61
- $ pwrdrvr preflight
62
-
63
- OPTIONS
64
- -a, --app-name=app-name MicroApps app name (this becomes the path the app is rooted at)
65
- -d, --deployer-lambda-name=deployer-lambda-name Name of the deployer lambda function
66
- -n, --new-version=new-version New semantic version to apply
67
-
68
- -o, --overwrite Allow overwrite - Warn but do not fail if version exists.
69
- Discouraged outside of test envs if cacheable static files have
70
- changed.
71
-
72
- -v, --version show CLI version
73
-
74
- --help show CLI help
75
-
76
- EXAMPLE
77
- $ pwrdrvr preflight -d microapps-deployer-dev -a release -n 0.0.13
78
- ✔ Preflight Version Check [0.2s]
79
- ```
80
-
81
- ## Command - publish
82
-
83
- `npx pwrdrvr publish help`
84
-
85
- ```
86
- Publish arbitrary framework app - deploy static assets to S3, alias the $LATEST Lambda function, and add integration/route to API Gateway.
87
-
88
- USAGE
89
- $ pwrdrvr publish
90
-
91
- OPTIONS
92
- -a, --app-name=app-name MicroApps app name (this becomes the path the app is rooted at)
93
- -d, --deployer-lambda-name=deployer-lambda-name Name of the deployer lambda function
94
-
95
- -i, --default-file=default-file Default file to return when the app is loaded via the router
96
- without a version (e.g. when app/ is requested).
97
-
98
- -l, --app-lambda-name=app-lambda-name ARN of lambda version, alias, or function (name or ARN) to deploy
99
-
100
- -n, --new-version=new-version New semantic version to apply
101
-
102
- -o, --overwrite Allow overwrite - Warn but do not fail if version exists.
103
- Discouraged outside of test envs if cacheable static files have
104
- changed.
105
-
106
- -s, --static-assets-path=static-assets-path Path to files to be uploaded to S3 static bucket at app/version/
107
- path. Do include app/version/ in path if files are already
108
- "rooted" under that path locally.
109
-
110
- -t, --type=(apigwy|lambda-url|url|static) [default: lambda-url] Type of the application and how its
111
- requests are routed
112
-
113
- -u, --url=url URL for `url` type applications
114
-
115
- -v, --version show CLI version
116
-
117
- --help show CLI help
118
-
119
- --no-cache Force revalidation of CloudFront and browser caching of static
120
- assets
121
-
122
- --startup-type=(iframe|direct) [default: iframe] How the app should be loaded
123
-
124
- EXAMPLE
125
- $ pwrdrvr publish -d microapps-deployer-dev -l microapps-app-release-dev -a release -n 0.0.21
126
- ✔ Get S3 Temp Credentials [1s]
127
- ✔ Deploy to Lambda [0.6s]
128
- ✔ Confirm Static Assets Folder Exists [0.0s]
129
- ✔ Copy Static Files to Local Upload Dir [0.0s]
130
- ✔ Enumerate Files to Upload to S3 [0.0s]
131
- ✔ Upload Static Files to S3 [1s]
132
- ✔ Creating MicroApp Application: release [0.0s]
133
- ✔ Creating MicroApp Version: 0.0.21 [1s]
134
- ```
135
-
136
- ## Command - publish-static
137
-
138
- `npx pwrdrvr publish-static help`
139
-
140
- ```
141
- Publish arbitrary framework static app - deploy static assets to S3 only.
142
-
143
- USAGE
144
- $ pwrdrvr publish-static
145
-
146
- OPTIONS
147
- -a, --app-name=app-name MicroApps app name (this becomes the path the app is rooted at)
148
- -d, --deployer-lambda-name=deployer-lambda-name Name of the deployer lambda function
149
-
150
- -i, --default-file=default-file Default file to return when the app is loaded via the router
151
- without a version (e.g. when app/ is requested).
152
-
153
- -n, --new-version=new-version New semantic version to apply
154
-
155
- -o, --overwrite Allow overwrite - Warn but do not fail if version exists.
156
- Discouraged outside of test envs if cacheable static files have
157
- changed.
158
-
159
- -s, --static-assets-path=static-assets-path Path to files to be uploaded to S3 static bucket at app/version/
160
- path. Do include app/version/ in path if files are already
161
- "rooted" under that path locally.
162
-
163
- -v, --version show CLI version
164
-
165
- --help show CLI help
166
-
167
- --no-cache Force revalidation of CloudFront and browser caching of static
168
- assets
169
-
170
- EXAMPLE
171
- $ pwrdrvr publish-static -d microapps-deployer-dev -l microapps-app-release-dev -a release -n 0.0.21
172
- ✔ Get S3 Temp Credentials [1s]
173
- ✔ Confirm Static Assets Folder Exists [0.0s]
174
- ✔ Copy Static Files to Local Upload Dir [0.0s]
175
- ✔ Enumerate Files to Upload to S3 [0.0s]
176
- ✔ Upload Static Files to S3 [1s]
177
- ✔ Creating MicroApp Application: release [0.0s]
178
- ✔ Creating MicroApp Version: 0.0.21 [1s]
179
- ```
180
-
181
- ## Command - nextjs-version
182
-
183
- `npx pwrdrvr nextjs-version help`
184
-
185
- ```
186
- Apply version to next.config.js overtop of 0.0.0 placeholder
187
-
188
- USAGE
189
- $ pwrdrvr nextjs-version
190
-
191
- OPTIONS
192
- -l, --leave-copy Leave a copy of the modifed files as .modified
193
- -n, --new-version=new-version New semantic version to apply
194
- -v, --version show CLI version
195
- --help show CLI help
196
-
197
- EXAMPLE
198
- $ pwrdrvr nextjs-version -n 0.0.13
199
- ✔ Modifying Config Files [0.0s]
200
- ```
201
-
202
- ## Command - nextjs-version-restore
203
-
204
- `npx pwrdrvr nextjs-version-restore help`
205
-
206
- ```
207
- Restore next.config.js
208
-
209
- USAGE
210
- $ pwrdrvr nextjs-version-restore
211
-
212
- OPTIONS
213
- -v, --version show CLI version
214
- --help show CLI help
215
-
216
- EXAMPLE
217
- $ pwrdrvr nextjs-version-restore
218
- ✔ Restoring Modified Config Files [0.0s]
219
- ```
220
-
221
- ## Command - delete
222
-
223
- `npx pwrdrvr delete help`
224
-
225
- ```
226
- Delete app/version
227
-
228
- USAGE
229
- $ pwrdrvr delete
230
-
231
- OPTIONS
232
- -a, --app-name=app-name MicroApps app name (this becomes the path the app is rooted at)
233
- -d, --deployer-lambda-name=deployer-lambda-name Name of the deployer lambda function
234
- -n, --new-version=new-version New semantic version to apply
235
- -v, --version show CLI version
236
- --help show CLI help
237
-
238
- EXAMPLE
239
- $ pwrdrvr delete -d microapps-deployer-dev -a release -n 0.0.13
240
- ✔ App/Version deleted: release/0.0.13 [1.2s]
241
- ```
6
+ For the full CLI documentation, installation details, and examples, see the
7
+ [`pwrdrvr` README](https://github.com/pwrdrvr/microapps-core/tree/main/packages/pwrdrvr).
package/bin/run CHANGED
File without changes
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@pwrdrvr/microapps-publish",
3
- "version": "1.1.2",
3
+ "version": "1.2.0-beta.4",
4
4
  "description": "Convenience package: renamed to `pwrdrvr`",
5
5
  "publishConfig": {
6
6
  "access": "public"
@@ -10,10 +10,7 @@
10
10
  },
11
11
  "engineStrict": true,
12
12
  "engine": {
13
- "node": ">= 16.0.0"
14
- },
15
- "scripts": {
16
- "test": "echo \"Error: no test specified\" && exit 1"
13
+ "node": ">= 22.0.0"
17
14
  },
18
15
  "files": [
19
16
  "package.json",
@@ -31,8 +28,11 @@
31
28
  },
32
29
  "homepage": "https://github.com/pwrdrvr/microapps-core#readme",
33
30
  "dependencies": {
34
- "pwrdrvr": "*"
31
+ "pwrdrvr": "1.2.0-beta.4"
35
32
  },
36
33
  "peerDependencies": {},
37
- "devDependencies": {}
38
- }
34
+ "devDependencies": {},
35
+ "scripts": {
36
+ "test": "echo \"Error: no test specified\" && exit 1"
37
+ }
38
+ }