@travetto/pack 8.0.0-alpha.17 → 8.0.0-alpha.19

package/README.md

@@ -22,12 +22,18 @@ There are three primary cli commands for packing your code:
 
 ## CLI - pack
 
-**Terminal: Pack usage**
+**Terminal: Help for pack**
 ```bash
 $ trv pack --help
 
 Usage: pack [options] [args...:string]
 
+Build a standard module package artifact.
+
+This base command produces the default packaged output and serves as the
+common entry point for module packaging workflows.
+Example Usage:
+
 Options:
   -b, --buildDir <string>              Workspace for building (default: "/tmp/<temp-folder>")
   --clean, --no-clean                  Clean workspace (default: true)
@@ -88,12 +94,18 @@ Every [Pack](https://github.com/travetto/travetto/tree/main/module/pack#readme "
 ## CLI - pack:zip
 This command is nearly identical to the standard `pack` operation, except for the `output` flag.  In this scenario, the `output` flag determines the location and name of the final zip file.
 
-**Terminal: Pack:zip usage**
+**Terminal: Help for pack:zip**
 ```bash
 $ trv pack:zip --help
 
 Usage: pack:zip [options] [args...:string]
 
+Build a deployable zip artifact using the standard pack pipeline.
+
+This command runs base packing operations and then compresses the generated
+output into a single archive file.
+Example Usage:
+
 Options:
   -b, --buildDir <string>              Workspace for building (default: "/tmp/<temp-folder>")
   --clean, --no-clean                  Clean workspace (default: true)
@@ -117,12 +129,18 @@ Options:
 ## CLI - pack:docker
 This command starts off identical to the standard `pack` operation, but it contains a few additional flags, and ultimately a few additional operations to support creating of the final [docker](https://www.docker.com/community-edition) image.
 
-**Terminal: Pack:docker usage**
+**Terminal: Help for pack:docker**
 ```bash
 $ trv pack:docker --help
 
 Usage: pack:docker [options] [args...:string]
 
+Build container-ready artifacts and optionally publish Docker images.
+
+Extends the core pack pipeline with Dockerfile generation and image build/
+push operations, including runtime user and registry customization.
+Example Usage:
+
 Options:
   -b, --buildDir <string>                Workspace for building (default: "/tmp/<temp-folder>")
   --clean, --no-clean                    Clean workspace (default: true)
@@ -141,7 +159,7 @@ Options:
   -np, --npm-package <string>            External NPM Packages (default: [])
   -m, --module <module>                  Module to run for
   -df, --docker-factory <string>         Docker Factory source (default: "@travetto/pack/support/pack.dockerfile.ts")
-  -di, --docker-image <string>           Docker Image to extend (default: "node:25-alpine")
+  -di, --docker-image <string>           Docker Image to extend (default: "node:26-alpine")
   -dn, --docker-name <string>            Docker Image Name (default: "<module>")
   -ru, --runtime-user <string>           Docker Runtime user
   -rp, --runtime-package <string>        Docker Runtime Packages (default: [])
@@ -244,21 +262,21 @@ cd $TRV_OUT
 node $REPO_ROOT/node_modules/.bin/rollup -c $TRV_OUT/node_modules/@travetto/pack/support/rollup/build.js
 cd $ROOT
 
-# Pulling Docker Base Image node:25-alpine 
+# Pulling Docker Base Image node:26-alpine 
 
-echo "Pulling Docker Base Image node:25-alpine"
+echo "Pulling Docker Base Image node:26-alpine"
 
-docker pull node:25-alpine
+docker pull node:26-alpine
 
-# Detected Image OS node:25-alpine as alpine 
+# Detected Image OS node:26-alpine as alpine 
 
-echo "Detected Image OS node:25-alpine as alpine"
+echo "Detected Image OS node:26-alpine as alpine"
 
 # Generating Docker File $DIST/Dockerfile @travetto/pack/support/pack.dockerfile.ts 
 
 echo "Generating Docker File $DIST/Dockerfile @travetto/pack/support/pack.dockerfile.ts"
 
-echo "FROM node:25-alpine" > $DIST/Dockerfile
+echo "FROM node:26-alpine" > $DIST/Dockerfile
 echo "RUN addgroup -g 2000 app && adduser -D -G app -u 2000 app" >> $DIST/Dockerfile
 echo "RUN mkdir /app && chown app:app /app" >> $DIST/Dockerfile
 echo "COPY --chown=\"app:app\" . /app" >> $DIST/Dockerfile

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@travetto/pack",
-  "version": "8.0.0-alpha.17",
+  "version": "8.0.0-alpha.19",
   "type": "module",
   "description": "Code packing utilities",
   "keywords": [
@@ -26,16 +26,16 @@
     "directory": "module/pack"
   },
   "dependencies": {
-    "@rollup/plugin-commonjs": "^29.0.2",
+    "@rollup/plugin-commonjs": "^29.0.3",
     "@rollup/plugin-json": "^6.1.0",
     "@rollup/plugin-node-resolve": "^16.0.3",
     "@rollup/plugin-terser": "^1.0.0",
-    "@travetto/runtime": "^8.0.0-alpha.14",
-    "@travetto/terminal": "^8.0.0-alpha.14",
-    "rollup": "^4.60.1"
+    "@travetto/runtime": "^8.0.0-alpha.16",
+    "@travetto/terminal": "^8.0.0-alpha.16",
+    "rollup": "^4.61.1"
   },
   "peerDependencies": {
-    "@travetto/cli": "^8.0.0-alpha.20"
+    "@travetto/cli": "^8.0.0-alpha.22"
   },
   "peerDependenciesMeta": {
     "@travetto/cli": {

package/support/cli.pack.ts

@@ -3,7 +3,10 @@ import { CliCommand } from '@travetto/cli';
 import { BasePackCommand } from './pack.base.ts';
 
 /**
- * Standard pack support
+ * Build a standard module package artifact.
+ *
+ * This base command produces the default packaged output and serves as the
+ * common entry point for module packaging workflows.
  */
 @CliCommand()
 export class PackCommand extends BasePackCommand { }

package/support/cli.pack_docker.ts

@@ -13,7 +13,10 @@ const asNumber = (input?: string): number | undefined => (!input || isNaN(+input
 const asString = (input?: string): string | undefined => (input && asNumber(input)) ? input : undefined;
 
 /**
- * Standard docker support for pack
+ * Build container-ready artifacts and optionally publish Docker images.
+ *
+ * Extends the core pack pipeline with Dockerfile generation and image build/
+ * push operations, including runtime user and registry customization.
  */
 @CliCommand()
 export class PackDockerCommand extends BasePackCommand {

package/support/cli.pack_zip.ts

@@ -4,7 +4,10 @@ import { PackOperation } from './bin/operation.ts';
 import { BasePackCommand, type PackOperationShape } from './pack.base.ts';
 
 /**
- * Standard zip support for pack
+ * Build a deployable zip artifact using the standard pack pipeline.
+ *
+ * This command runs base packing operations and then compresses the generated
+ * output into a single archive file.
  */
 @CliCommand()
 export class PackZipCommand extends BasePackCommand {