do-functions-cli 1.4.0 → 1.5.0

package/README.md

@@ -82,6 +82,39 @@ your-project/
 └── project.yml                 # DigitalOcean project configuration
 ```
 
+## Bundling with esbuild
+
+The generated function templates include [esbuild](https://esbuild.github.io/) for bundling your code. This ensures compatibility with DigitalOcean Functions by:
+
+- **Bundling all dependencies** — All `node_modules` are bundled into a single file (`dist/bundle.js`)
+- **CommonJS output** — Code is transpiled to CommonJS format (`--format=cjs`) for compatibility with the DigitalOcean Functions runtime
+- **Node.js 18 targeting** — The bundle is optimized for Node.js 18 (`--target=node18`)
+- **Minification** — Output is minified to reduce file size and improve cold start times
+
+### Build Script
+
+Each function includes a `build` script in `package.json`:
+
+```bash
+# JavaScript
+esbuild ./index.js --bundle --platform=node --target=node18 --format=cjs --outfile=./dist/bundle.js --minify
+
+# TypeScript (includes type checking)
+tsc --noEmit && esbuild ./index.ts --bundle --platform=node --target=node18 --format=cjs --outfile=./dist/bundle.js --minify
+```
+
+DigitalOcean automatically runs `npm run build` during deployment, so you don't need to build manually before deploying.
+
+### The .include File
+
+Each function contains a `.include` file that tells DigitalOcean which files to include in the deployed function. By default, it points to the bundled output:
+
+```
+dist/bundle.js
+```
+
+This means only the bundled file is deployed, keeping your function package small and fast.
+
 ## project.yml Configuration
 
 The CLI automatically manages your `project.yml` file:
@@ -97,7 +130,7 @@ packages:
 
 ## Requirements
 
-- Node.js 18 or later
+- Node.js 20.12.0 or later
 - npm or compatible package manager
 
 ## Roadmap

package/dist/cli.js

@@ -3,13 +3,9 @@ import { Command } from 'commander';
 import fs from 'fs-extra/esm';
 import createCommand from './commands/create.js';
 const packageJson = await fs.readJSON(new URL('../package.json', import.meta.url));
-const cliVersion = packageJson.version;
 // Initialize the main CLI program
 const program = new Command();
-program
-    .name('do-functions-cli')
-    .description('CLI tool for managing DigitalOcean serverless functions')
-    .version(cliVersion);
+program.name(packageJson.name).description(packageJson.description).version(packageJson.version);
 // Register the 'create' command for creating new serverless functions
 program.addCommand(createCommand);
 // Parse command-line arguments and execute

package/dist/cli.js.map

@@ -1 +1 @@
-{"version":3,"file":"cli.js","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":";AACA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EAAE,MAAM,cAAc,CAAC;AAE9B,OAAO,aAAa,MAAM,sBAAsB,CAAC;AAEjD,MAAM,WAAW,GAAG,MAAM,EAAE,CAAC,QAAQ,CAAC,IAAI,GAAG,CAAC,iBAAiB,EAAE,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC;AACnF,MAAM,UAAU,GAAG,WAAW,CAAC,OAAO,CAAC;AAEvC,kCAAkC;AAClC,MAAM,OAAO,GAAG,IAAI,OAAO,EAAE,CAAC;AAC9B,OAAO;KACJ,IAAI,CAAC,kBAAkB,CAAC;KACxB,WAAW,CAAC,yDAAyD,CAAC;KACtE,OAAO,CAAC,UAAU,CAAC,CAAC;AAEvB,sEAAsE;AACtE,OAAO,CAAC,UAAU,CAAC,aAAa,CAAC,CAAC;AAElC,2CAA2C;AAC3C,OAAO,CAAC,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;AAE5B;;;;GAIG;AACH,OAAO,CAAC,EAAE,CAAC,mBAAmB,EAAE,CAAC,KAAK,EAAE,EAAE;IACxC,IAAI,KAAK,YAAY,KAAK,IAAI,KAAK,CAAC,IAAI,KAAK,iBAAiB,EAAE,CAAC;QAC/D,OAAO,CAAC,GAAG,CAAC,qBAAqB,CAAC,CAAC;QACnC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;SAAM,CAAC;QACN,OAAO,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;QACrB,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;AACH,CAAC,CAAC,CAAC"}
+{"version":3,"file":"cli.js","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":";AACA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EAAE,MAAM,cAAc,CAAC;AAE9B,OAAO,aAAa,MAAM,sBAAsB,CAAC;AAEjD,MAAM,WAAW,GAAG,MAAM,EAAE,CAAC,QAAQ,CAAC,IAAI,GAAG,CAAC,iBAAiB,EAAE,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC;AAEnF,kCAAkC;AAClC,MAAM,OAAO,GAAG,IAAI,OAAO,EAAE,CAAC;AAC9B,OAAO,CAAC,IAAI,CAAC,WAAW,CAAC,IAAI,CAAC,CAAC,WAAW,CAAC,WAAW,CAAC,WAAW,CAAC,CAAC,OAAO,CAAC,WAAW,CAAC,OAAO,CAAC,CAAC;AAEjG,sEAAsE;AACtE,OAAO,CAAC,UAAU,CAAC,aAAa,CAAC,CAAC;AAElC,2CAA2C;AAC3C,OAAO,CAAC,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;AAE5B;;;;GAIG;AACH,OAAO,CAAC,EAAE,CAAC,mBAAmB,EAAE,CAAC,KAAK,EAAE,EAAE;IACxC,IAAI,KAAK,YAAY,KAAK,IAAI,KAAK,CAAC,IAAI,KAAK,iBAAiB,EAAE,CAAC;QAC/D,OAAO,CAAC,GAAG,CAAC,qBAAqB,CAAC,CAAC;QACnC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;SAAM,CAAC;QACN,OAAO,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;QACrB,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;AACH,CAAC,CAAC,CAAC"}

package/package.json

@@ -1,13 +1,21 @@
 {
   "name": "do-functions-cli",
-  "version": "1.4.0",
+  "version": "1.5.0",
+  "description": "CLI tool for scaffolding DigitalOcean Serverless Functions with JavaScript and TypeScript templates, automatic dependency installation, and project.yml configuration.",
   "type": "module",
   "repository": {
     "type": "git",
     "url": "git+https://github.com/grantchatterton/do-functions-cli.git"
   },
+  "homepage": "https://github.com/grantchatterton/do-functions-cli#readme",
+  "bugs": {
+    "url": "https://github.com/grantchatterton/do-functions-cli/issues"
+  },
   "author": "Grant Chatterton",
   "license": "MIT",
+  "engines": {
+    "node": ">=20.12.0"
+  },
   "bin": {
     "do-functions-cli": "dist/cli.js"
   },
@@ -48,13 +56,20 @@
     "templates"
   ],
   "keywords": [
+    "digitalocean",
+    "serverless",
     "functions",
-    "utility",
-    "typescript",
+    "faas",
     "cli",
-    "npm",
-    "do",
-    "digitalocean",
-    "serverless"
+    "scaffold",
+    "generator",
+    "typescript",
+    "javascript",
+    "nodejs",
+    "cloud-functions",
+    "serverless-functions",
+    "do-functions",
+    "function-template",
+    "project-generator"
   ]
 }