@design-edito/cli 0.0.77 → 0.0.79

package/cli/assets/list.txt

@@ -1,4 +1,3 @@
 cli
 make-template
-tree
-upgrade
+tree

package/cli/assets/version.txt

@@ -1 +1 @@
-0.0.77
+0.0.79

package/cli/index.js

@@ -1,5 +1,5 @@
 #!/usr/bin/env node
-import m from"node:process";import{promises as l}from"node:fs";import f from"node:url";import r from"node:path";import{spawn as g}from"node:child_process";import{program as t}from"commander";var h=f.fileURLToPath(import.meta.url),a=r.dirname(h);t.name("@design-edito/cli").description("The home of @design-edito/cli's project");t.command("list").description("list all the available commands").action(j);t.command("version").description("print current version of the package").action(v);var w=await c();w.forEach(n=>{t.command(n,{hidden:!0}).allowUnknownOption(!0).action(async(...i)=>{let[o,e,s,...d]=m.argv;if(s===void 0)return t.help();if(!(await c()).includes(s))return t.help();let p=r.join(a,"../",s,"index.js");g(p,d,{stdio:"inherit"}).on("error",u=>console.error(`Failed to start subprogram '${s}':`,u))})});t.parse(m.argv);async function c(){let n=r.join(a,"assets/list.txt");return(await l.readFile(n,{encoding:"utf-8"})).split(`
+import m from"node:process";import{promises as l}from"node:fs";import h from"node:url";import r from"node:path";import{spawn as g}from"node:child_process";import{program as n}from"commander";var v=h.fileURLToPath(import.meta.url),a=r.dirname(v);n.name("@design-edito/cli").description("The home of @design-edito/cli's project").option("-v, --version","output the current version").action(async t=>"version"in t?await p():n.help());n.command("list").description("list all the available commands").action(j);n.command("version").description("print current version of the package").action(p);var w=await c();w.forEach(t=>{n.command(t,{hidden:!0}).allowUnknownOption(!0).action(async(...i)=>{let[o,e,s,...d]=m.argv;if(s===void 0)return n.help();if(!(await c()).includes(s))return n.help();let u=r.join(a,"../",s,"index.js");g(u,d,{stdio:"inherit"}).on("error",f=>console.error(`Failed to start subprogram '${s}':`,f))})});n.parse(m.argv);async function c(){let t=r.join(a,"assets/list.txt");return(await l.readFile(t,{encoding:"utf-8"})).split(`
 `).map(o=>o.trim())}async function j(){let i=(await c()).map(o=>{let e=Object.assign(new Array(24).fill(" "),o.split("")).join("");return o==="cli"?`${e} # npx @design-edito/cli help`:`${e} # npx @design-edito/cli ${o} help`}).join(`
-`);console.log(i)}async function v(){let n=r.join(a,"assets/version.txt"),i=await l.readFile(n,{encoding:"utf-8"});console.log(i)}
+`);console.log(i)}async function p(){let t=r.join(a,"assets/version.txt"),i=await l.readFile(t,{encoding:"utf-8"});console.log(i)}
 //# sourceMappingURL=index.js.map

package/cli/index.js.map

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../../src/cli/index.ts"],
-  "sourcesContent": ["import process from 'node:process'\nimport { promises as fs } from 'node:fs'\nimport url from 'node:url'\nimport path from 'node:path'\nimport { spawn } from 'node:child_process'\nimport { program } from 'commander'\n\nconst __filename = url.fileURLToPath(import.meta.url)\nconst __dirname = path.dirname(__filename)\n\nprogram\n  .name('@design-edito/cli')\n  .description('The home of @design-edito/cli\\'s project')\n  \nprogram\n  .command('list')\n  .description('list all the available commands')\n  .action(printCommands)\n\nprogram\n  .command('version')\n  .description('print current version of the package')\n  .action(printVersion)\n\nconst subCommands = await listCommands()\nsubCommands.forEach(subCommand => {\n  program\n    .command(subCommand, { hidden: true })\n    .allowUnknownOption(true)\n    .action(async (...args) => {\n      const [_nodePath, _thisPath, targetCommand, ...forwardedArgs] = process.argv\n      if (targetCommand === undefined) return program.help()\n      const commandsList = await listCommands()\n      if (!commandsList.includes(targetCommand)) return program.help()\n      const subprogramPath = path.join(__dirname, '../', targetCommand, 'index.js')\n      const subprocess = spawn(subprogramPath, forwardedArgs, { stdio: 'inherit' })\n      subprocess.on('error', err => console.error(`Failed to start subprogram '${targetCommand}':`, err))\n    })\n})\n\nprogram.parse(process.argv)\n\nasync function listCommands () {\n  const listFilePath = path.join(__dirname, 'assets/list.txt')\n  const list = await fs.readFile(listFilePath, { encoding: 'utf-8' })\n  return list.split('\\n').map(e => e.trim())\n}\n\nasync function printCommands () {\n  const list = await listCommands()\n  const output = list\n    .map(c => {\n      const twentyFourCharName = Object.assign(\n        new Array(24).fill(' ') as string[],\n        c.split('') as string[]\n      ).join('')\n      if (c === 'cli') return `${twentyFourCharName} # npx @design-edito/cli help`\n      return `${twentyFourCharName} # npx @design-edito/cli ${c} help`\n    })\n    .join('\\n')\n  console.log(output)\n  return;\n}\n\nasync function printVersion () {\n  const versionFilePath = path.join(__dirname, 'assets/version.txt')\n  const version = await fs.readFile(versionFilePath, { encoding: 'utf-8' })\n  console.log(version)\n  return;\n}\n"],
-  "mappings": "AAAA,OAAOA,MAAa,eACpB,OAAS,YAAYC,MAAU,UAC/B,OAAOC,MAAS,WAChB,OAAOC,MAAU,YACjB,OAAS,SAAAC,MAAa,qBACtB,OAAS,WAAAC,MAAe,YAExB,IAAMC,EAAaJ,EAAI,cAAc,YAAY,GAAG,EAC9CK,EAAYJ,EAAK,QAAQG,CAAU,EAEzCD,EACG,KAAK,mBAAmB,EACxB,YAAY,yCAA0C,EAEzDA,EACG,QAAQ,MAAM,EACd,YAAY,iCAAiC,EAC7C,OAAOG,CAAa,EAEvBH,EACG,QAAQ,SAAS,EACjB,YAAY,sCAAsC,EAClD,OAAOI,CAAY,EAEtB,IAAMC,EAAc,MAAMC,EAAa,EACvCD,EAAY,QAAQE,GAAc,CAChCP,EACG,QAAQO,EAAY,CAAE,OAAQ,EAAK,CAAC,EACpC,mBAAmB,EAAI,EACvB,OAAO,SAAUC,IAAS,CACzB,GAAM,CAACC,EAAWC,EAAWC,EAAe,GAAGC,CAAa,EAAIjB,EAAQ,KACxE,GAAIgB,IAAkB,OAAW,OAAOX,EAAQ,KAAK,EAErD,GAAI,EADiB,MAAMM,EAAa,GACtB,SAASK,CAAa,EAAG,OAAOX,EAAQ,KAAK,EAC/D,IAAMa,EAAiBf,EAAK,KAAKI,EAAW,MAAOS,EAAe,UAAU,EACzDZ,EAAMc,EAAgBD,EAAe,CAAE,MAAO,SAAU,CAAC,EACjE,GAAG,QAASE,GAAO,QAAQ,MAAM,+BAA+BH,CAAa,KAAMG,CAAG,CAAC,CACpG,CAAC,CACL,CAAC,EAEDd,EAAQ,MAAML,EAAQ,IAAI,EAE1B,eAAeW,GAAgB,CAC7B,IAAMS,EAAejB,EAAK,KAAKI,EAAW,iBAAiB,EAE3D,OADa,MAAMN,EAAG,SAASmB,EAAc,CAAE,SAAU,OAAQ,CAAC,GACtD,MAAM;AAAA,CAAI,EAAE,IAAIC,GAAKA,EAAE,KAAK,CAAC,CAC3C,CAEA,eAAeb,GAAiB,CAE9B,IAAMc,GADO,MAAMX,EAAa,GAE7B,IAAIY,GAAK,CACR,IAAMC,EAAqB,OAAO,OAChC,IAAI,MAAM,EAAE,EAAE,KAAK,GAAG,EACtBD,EAAE,MAAM,EAAE,CACZ,EAAE,KAAK,EAAE,EACT,OAAIA,IAAM,MAAc,GAAGC,CAAkB,gCACtC,GAAGA,CAAkB,4BAA4BD,CAAC,OAC3D,CAAC,EACA,KAAK;AAAA,CAAI,EACZ,QAAQ,IAAID,CAAM,CAEpB,CAEA,eAAeb,GAAgB,CAC7B,IAAMgB,EAAkBtB,EAAK,KAAKI,EAAW,oBAAoB,EAC3DmB,EAAU,MAAMzB,EAAG,SAASwB,EAAiB,CAAE,SAAU,OAAQ,CAAC,EACxE,QAAQ,IAAIC,CAAO,CAErB",
-  "names": ["process", "fs", "url", "path", "spawn", "program", "__filename", "__dirname", "printCommands", "printVersion", "subCommands", "listCommands", "subCommand", "args", "_nodePath", "_thisPath", "targetCommand", "forwardedArgs", "subprogramPath", "err", "listFilePath", "e", "output", "c", "twentyFourCharName", "versionFilePath", "version"]
+  "sourcesContent": ["import process from 'node:process'\nimport { promises as fs } from 'node:fs'\nimport url from 'node:url'\nimport path from 'node:path'\nimport { spawn } from 'node:child_process'\nimport { program } from 'commander'\n\nconst __filename = url.fileURLToPath(import.meta.url)\nconst __dirname = path.dirname(__filename)\n\nprogram\n  .name('@design-edito/cli')\n  .description('The home of @design-edito/cli\\'s project')\n  .option('-v, --version', 'output the current version')\n  .action(async options => 'version' in options\n    ? await printVersion()\n    : program.help())\n  \nprogram\n  .command('list')\n  .description('list all the available commands')\n  .action(printCommands)\n\nprogram\n  .command('version')\n  .description('print current version of the package')\n  .action(printVersion)\n\nconst subCommands = await listCommands()\nsubCommands.forEach(subCommand => {\n  program\n    .command(subCommand, { hidden: true })\n    .allowUnknownOption(true)\n    .action(async (...args) => {\n      const [_nodePath, _thisPath, targetCommand, ...forwardedArgs] = process.argv\n      if (targetCommand === undefined) return program.help()\n      const commandsList = await listCommands()\n      if (!commandsList.includes(targetCommand)) return program.help()\n      const subprogramPath = path.join(__dirname, '../', targetCommand, 'index.js')\n      const subprocess = spawn(subprogramPath, forwardedArgs, { stdio: 'inherit' })\n      subprocess.on('error', err => console.error(`Failed to start subprogram '${targetCommand}':`, err))\n    })\n})\n\nprogram.parse(process.argv)\n\nasync function listCommands () {\n  const listFilePath = path.join(__dirname, 'assets/list.txt')\n  const list = await fs.readFile(listFilePath, { encoding: 'utf-8' })\n  return list.split('\\n').map(e => e.trim())\n}\n\nasync function printCommands () {\n  const list = await listCommands()\n  const output = list\n    .map(c => {\n      const twentyFourCharName = Object.assign(\n        new Array(24).fill(' ') as string[],\n        c.split('') as string[]\n      ).join('')\n      if (c === 'cli') return `${twentyFourCharName} # npx @design-edito/cli help`\n      return `${twentyFourCharName} # npx @design-edito/cli ${c} help`\n    })\n    .join('\\n')\n  console.log(output)\n  return;\n}\n\nasync function printVersion () {\n  const versionFilePath = path.join(__dirname, 'assets/version.txt')\n  const version = await fs.readFile(versionFilePath, { encoding: 'utf-8' })\n  console.log(version)\n  return;\n}\n"],
+  "mappings": "AAAA,OAAOA,MAAa,eACpB,OAAS,YAAYC,MAAU,UAC/B,OAAOC,MAAS,WAChB,OAAOC,MAAU,YACjB,OAAS,SAAAC,MAAa,qBACtB,OAAS,WAAAC,MAAe,YAExB,IAAMC,EAAaJ,EAAI,cAAc,YAAY,GAAG,EAC9CK,EAAYJ,EAAK,QAAQG,CAAU,EAEzCD,EACG,KAAK,mBAAmB,EACxB,YAAY,yCAA0C,EACtD,OAAO,gBAAiB,4BAA4B,EACpD,OAAO,MAAMG,GAAW,YAAaA,EAClC,MAAMC,EAAa,EACnBJ,EAAQ,KAAK,CAAC,EAEpBA,EACG,QAAQ,MAAM,EACd,YAAY,iCAAiC,EAC7C,OAAOK,CAAa,EAEvBL,EACG,QAAQ,SAAS,EACjB,YAAY,sCAAsC,EAClD,OAAOI,CAAY,EAEtB,IAAME,EAAc,MAAMC,EAAa,EACvCD,EAAY,QAAQE,GAAc,CAChCR,EACG,QAAQQ,EAAY,CAAE,OAAQ,EAAK,CAAC,EACpC,mBAAmB,EAAI,EACvB,OAAO,SAAUC,IAAS,CACzB,GAAM,CAACC,EAAWC,EAAWC,EAAe,GAAGC,CAAa,EAAIlB,EAAQ,KACxE,GAAIiB,IAAkB,OAAW,OAAOZ,EAAQ,KAAK,EAErD,GAAI,EADiB,MAAMO,EAAa,GACtB,SAASK,CAAa,EAAG,OAAOZ,EAAQ,KAAK,EAC/D,IAAMc,EAAiBhB,EAAK,KAAKI,EAAW,MAAOU,EAAe,UAAU,EACzDb,EAAMe,EAAgBD,EAAe,CAAE,MAAO,SAAU,CAAC,EACjE,GAAG,QAASE,GAAO,QAAQ,MAAM,+BAA+BH,CAAa,KAAMG,CAAG,CAAC,CACpG,CAAC,CACL,CAAC,EAEDf,EAAQ,MAAML,EAAQ,IAAI,EAE1B,eAAeY,GAAgB,CAC7B,IAAMS,EAAelB,EAAK,KAAKI,EAAW,iBAAiB,EAE3D,OADa,MAAMN,EAAG,SAASoB,EAAc,CAAE,SAAU,OAAQ,CAAC,GACtD,MAAM;AAAA,CAAI,EAAE,IAAIC,GAAKA,EAAE,KAAK,CAAC,CAC3C,CAEA,eAAeZ,GAAiB,CAE9B,IAAMa,GADO,MAAMX,EAAa,GAE7B,IAAIY,GAAK,CACR,IAAMC,EAAqB,OAAO,OAChC,IAAI,MAAM,EAAE,EAAE,KAAK,GAAG,EACtBD,EAAE,MAAM,EAAE,CACZ,EAAE,KAAK,EAAE,EACT,OAAIA,IAAM,MAAc,GAAGC,CAAkB,gCACtC,GAAGA,CAAkB,4BAA4BD,CAAC,OAC3D,CAAC,EACA,KAAK;AAAA,CAAI,EACZ,QAAQ,IAAID,CAAM,CAEpB,CAEA,eAAed,GAAgB,CAC7B,IAAMiB,EAAkBvB,EAAK,KAAKI,EAAW,oBAAoB,EAC3DoB,EAAU,MAAM1B,EAAG,SAASyB,EAAiB,CAAE,SAAU,OAAQ,CAAC,EACxE,QAAQ,IAAIC,CAAO,CAErB",
+  "names": ["process", "fs", "url", "path", "spawn", "program", "__filename", "__dirname", "options", "printVersion", "printCommands", "subCommands", "listCommands", "subCommand", "args", "_nodePath", "_thisPath", "targetCommand", "forwardedArgs", "subprogramPath", "err", "listFilePath", "e", "output", "c", "twentyFourCharName", "versionFilePath", "version"]
 }

package/make-template/assets/express/esbuild.config.js

@@ -0,0 +1,19 @@
+import esbuild from 'esbuild'
+
+esbuild.build({
+  entryPoints: ['src/index.ts'],
+  outdir: 'dist',
+  bundle: true,
+  sourcemap: true,
+  platform: 'node',
+  target: 'node16',
+  format: 'esm',
+  logLevel: 'info',
+  external: [
+    'express',
+    'cookie-parser',
+    'morgan',
+    'debug',
+    'util'
+  ]
+}).catch(() => process.exit(1))

package/make-template/assets/express/package.json

@@ -1,30 +1,34 @@
 {
-  "name": "-",
+  "name": "<<@mxfb/cli----replace-with-name>>",
   "version": "0.0.0",
   "private": true,
   "type": "module",
   "scripts": {
-    "build:src": "npx esbuild --bundle src/index.ts --outdir=dist --sourcemap --platform=node --format=esm --external:debug --external:express --external:cookie-parser --external:morgan",
+    "build:src:public": "npx cpx 'src/public/**/*' dist/public",
+    "check:src": "npx tsc -p src/tsconfig.json --noEmit",
+    "build:src": "node esbuild.config.js && npm run build:src:public",
     "watch:src": "npm run build:src && npx chokidar 'src/**/*' -c 'npm run build:src'",
     "serve": "npx nodemon ./dist/index.js",
     "start:nowatch": "npm run build:src && npm run serve",
     "start": "npx concurrently -n 'watch:src ,serve     ' 'npm run watch:src' 'npm run serve'"
   },
   "dependencies": {
-    "cookie-parser": "~1.4.4",
-    "debug": "~2.6.9",
-    "express": "^4.19.2",
-    "morgan": "~1.9.1"
+    "cookie-parser": "^1.4.7",
+    "cors": "^2.8.5",
+    "debug": "^4.4.0",
+    "esbuild": "^0.25.0",
+    "express": "^4.21.2",
+    "morgan": "^1.10.0",
+    "typescript": "^5.7.3"
   },
   "devDependencies": {
-    "@types/cookie-parser": "^1.4.7",
+    "@types/cookie-parser": "^1.4.8",
+    "@types/cors": "^2.8.17",
     "@types/debug": "^4.1.12",
-    "@types/express": "^4.17.21",
+    "@types/express": "^5.0.0",
     "@types/morgan": "^1.9.9",
-    "@types/node": "^22.2.0",
+    "@types/node": "^22.13.4",
     "chokidar-cli": "^3.0.0",
-    "concurrently": "^8.2.2",
-    "esbuild": "^0.23.0",
-    "typescript": "^5.5.4"
+    "concurrently": "^9.1.2"
   }
 }

package/make-template/assets/express/src/index.ts

@@ -1,62 +1,26 @@
-import http from 'node:http'
 import path from 'node:path'
 import { fileURLToPath } from 'node:url'
-import express from 'express'
 import cookieParser from 'cookie-parser'
+import cors from 'cors'
+import express from 'express'
 import logger from 'morgan'
-import debugModule from 'debug'
-import indexRouter from './routes/index.js'
+import { serve } from './www'
 
-const debug = debugModule('<<@mxfb/cli----replace-with-name>>:server')
-const port = normalizePort(process.env.PORT ?? '3000')
+// App setup
 const app = express()
-const __dirname = path.dirname(fileURLToPath(import.meta.url))
-
-app.use(logger('dev'))
+app.use(cors()) // [WIP] configure cors and allowed origins
+app.use(logger('dev')) // [WIP] configure logger for prod an all
 app.use(express.json())
 app.use(express.urlencoded({ extended: false }))
 app.use(cookieParser())
-app.use(express.static(path.join(__dirname, 'public')))
-app.use('/', indexRouter)
-app.set('port', port)
-
-const server = http.createServer(app)
-
-server.listen(port)
-server.on('error', onError)
-server.on('listening', onListening)
-
-function normalizePort (val: string) {
-  var port = parseInt(val, 10)
-  if (isNaN(port)) return val
-  if (port >= 0) return port
-  return false
-}
 
-interface NodeError extends Error {
-  syscall?: string
-  code?: string
-}
+// Static files
+const ROOT = path.dirname(fileURLToPath(import.meta.url))
+const PUBLIC = path.join(ROOT, 'public')
+app.use(express.static(PUBLIC))
 
-function onError (error: NodeError) {
-  if (error.syscall !== 'listen') throw error
-  var bind = typeof port === 'string' ? 'Pipe ' + port : 'Port ' + port
-  switch (error.code) {
-    case 'EACCES':
-      console.error(bind + ' requires elevated privileges')
-      process.exit(1)
-      break
-    case 'EADDRINUSE':
-      console.error(bind + ' is already in use')
-      process.exit(1)
-      break
-    default:
-      throw error
-  }
-}
+// Routes
+app.get('/', (req, res) => res.send({ data: true }))
 
-function onListening () {
-  var addr = server.address()
-  var bind = typeof addr === 'string' ? 'pipe ' + addr : 'port ' + (addr?.port ?? '')
-  debug('Listening on ' + bind)
-}
+// Start server
+serve(app)

package/make-template/assets/express/src/public/index.css

@@ -0,0 +1,7 @@
+html {
+  font-family: system-ui, -apple-system, BlinkMacSystemFont, 'Segoe UI', Roboto, Oxygen, Ubuntu, Cantarell, 'Open Sans', 'Helvetica Neue', sans-serif;
+}
+
+button {
+  cursor: pointer;
+}

package/make-template/assets/express/src/public/index.html

@@ -0,0 +1,15 @@
+<!DOCTYPE html>
+<html>
+  <head>
+    <meta charset="utf-8">
+    <meta name="viewport" content="width=device-width, initial-scale=1">
+    <script type="module" src="./index.js"></script>
+    <link rel="stylesheet" href="./index.css">
+  </head>
+  <body>
+    <h1>LM-Publisher</h1>
+
+    <button class="create-random-project">Create random project</button>
+
+  </body>
+</html>

package/make-template/assets/express/src/public/index.js

@@ -0,0 +1,31 @@
+const $responses = document.querySelector('.requests')
+const $createRandomProject = document.querySelector('.create-random-project')
+
+async function fetchAndLog (url, method, body) {
+  const id = Math.random().toString(36).slice(2)
+  console.log('%cSending request...', 'font-weight: 600')
+  console.log('id:', id)
+  console.log(`${method}:`, url)
+  const response = await window.fetch(url, {
+    method,
+    body: JSON.stringify(body),
+    headers: { 'Content-Type': 'application/json' }
+  })
+  const json = await response.json()
+  console.log('%cReceived response', 'font-weight: 600')
+  console.log('id:', id)
+  console.log(`${method}:`, url)
+  console.log('body:', body)
+  console.log('response:', response)
+  console.log('json:', json)
+}
+
+$createRandomProject.addEventListener('click', () => {
+  fetchAndLog('http://localhost:3000/projects/create', 'POST', {
+    name: 'Mon premier projet :\')',
+    publicationTargetDate: Date.now(),
+    sourcesIds: [],
+    articlesIds: [],
+    assetsIds: [],
+  })
+})

package/make-template/assets/express/src/tsconfig.json

@@ -2,11 +2,15 @@
   "compilerOptions": {
     "target": "ESNext",
     "module": "ESNext",
-    "moduleResolution": "NodeNext",
+    "moduleResolution": "Node",
     "esModuleInterop": true,
+    "declaration": true,
     "forceConsistentCasingInFileNames": true,
     "strict": true,
     "skipLibCheck": true,
-    "noUncheckedIndexedAccess": true
-  }
+    "noUncheckedIndexedAccess": true,
+    "strictNullChecks": true,
+    "noEmit": true
+  },
+  "include": ["./**/*"]
 }

package/make-template/assets/express/src/www/index.ts

@@ -0,0 +1,42 @@
+import http from 'node:http'
+import debugModule from 'debug'
+import { Express } from 'express'
+
+interface NodeError extends Error {
+  syscall?: string
+  code?: string
+}
+
+export function serve (app: Express) {
+  const port = normalizePort(process.env.PORT ?? '3000')
+  const debug = debugModule('<<@mxfb/cli----replace-with-name>>:server')
+  const server = http.createServer(app)
+  app.set('port', port)
+  server.listen(port)
+  server.on('error', (error: NodeError) => {
+    if (error.syscall !== 'listen') throw error
+    var bind = typeof port === 'string' ? 'Pipe ' + port : 'Port ' + port
+    switch (error.code) {
+      case 'EACCES':
+        console.error(bind + ' requires elevated privileges')
+        return process.exit(1)
+      case 'EADDRINUSE':
+        console.error(bind + ' is already in use')
+        return process.exit(1)
+      default:
+        throw error
+    }
+  })
+  server.on('listening', () => {
+    var addr = server.address()
+    var bind = typeof addr === 'string' ? 'pipe ' + addr : 'port ' + (addr?.port ?? '')
+    debug('Listening on ' + bind)
+  })
+
+  function normalizePort (val: string) {
+    var port = parseInt(val, 10)
+    if (isNaN(port)) return val
+    if (port >= 0) return port
+    return false
+  }
+}

package/make-template/assets/express-api/Dockerfile

@@ -0,0 +1,18 @@
+FROM node:20-alpine AS builder
+
+WORKDIR /app
+COPY package*.json ./
+COPY esbuild.config.js ./esbuild.config.js
+COPY src ./src
+RUN npm install --omit=dev
+RUN npm run build:src
+
+FROM node:20-alpine AS runner
+
+WORKDIR /app
+COPY --from=builder /app/dist ./dist
+COPY --from=builder /app/node_modules ./node_modules
+COPY package.json ./
+EXPOSE 3000
+
+CMD ["node", "dist/index.js"]

package/make-template/assets/express-api/Dockerfile.dev

@@ -0,0 +1,8 @@
+FROM node:20-alpine
+
+WORKDIR /app
+COPY package*.json ./
+COPY esbuild.config.js ./esbuild.config.js
+RUN npm install
+
+CMD ["npm", "start"]

package/make-template/assets/express-api/env

@@ -0,0 +1,36 @@
+# Mode (development, production)
+MODE=development
+
+# Location
+HOST=localhost:3000
+
+# Database
+DB_USR=db-user
+DB_PWD=db-pwd
+DB_URL=db-url
+DB_OPT=db_opt1=true&db_opt2=false
+
+# Agenda
+DB_RESERVED_AGENDA_JOBS_COLLECTION_NAME=__AgendaJobs
+
+# ROOT User
+ROOT_USER_ID=000000000000000000000000
+ROOT_USER_NAME=ROOT
+ROOT_USER_EMAIL=root@root.com
+ROOT_USER_PWD=rootpwd
+
+# User email validation token
+USER_EMAIL_VALIDATION_TOKEN_LIFETIME_MINUTES=60
+
+# JWT
+JWT_SECRET=jwt-secret
+ACCESS_TOKEN_EXPIRATION_SECONDS=900 # 15 minutes
+ACCESS_TOKEN_RENEWAL_THRESHOLD=300 # 5 minutes
+REFRESH_TOKEN_EXPIRATION_SECONDS=86400 # 1 day
+ACCESS_TOKEN_MAX_REFRESH_COUNT=5
+REFRESH_TOKEN_MAX_REFRESH_COUNT=5
+
+# Emailing
+MAILERSEND_API_KEY=mailersend-api-key
+EMAILER_EMAIL=noreply@noreply.com
+EMAILER_NAME=Noreply

package/make-template/assets/express-api/esbuild.config.js

@@ -0,0 +1,26 @@
+import esbuild from 'esbuild'
+
+esbuild.build({
+  entryPoints: ['src/index.ts'],
+  outdir: 'dist',
+  bundle: true,
+  sourcemap: true,
+  platform: 'node',
+  target: 'node16',
+  format: 'esm',
+  logLevel: 'info',
+  external: [
+    'mailersend',
+    'express',
+    'cookie-parser',
+    'morgan',
+    'mongoose',
+    'dotenv',
+    'debug',
+    '@mapbox',
+    'jsonwebtoken',
+    'bcrypt',
+    'util',
+    'agenda'
+  ]
+}).catch(() => process.exit(1))

package/make-template/assets/express-api/gitignore

@@ -0,0 +1,214 @@
+# Created by https://www.toptal.com/developers/gitignore/api/node,osx,linux,windows
+# Edit at https://www.toptal.com/developers/gitignore?templates=node,osx,linux,windows
+
+### Linux ###
+*~
+
+# temporary files which can be created if a process still has a handle open of a deleted file
+.fuse_hidden*
+
+# KDE directory preferences
+.directory
+
+# Linux trash folder which might appear on any partition or disk
+.Trash-*
+
+# .nfs files are created when an open file is removed but is still being accessed
+.nfs*
+
+### Node ###
+# Logs
+logs
+*.log
+npm-debug.log*
+yarn-debug.log*
+yarn-error.log*
+lerna-debug.log*
+.pnpm-debug.log*
+
+# Diagnostic reports (https://nodejs.org/api/report.html)
+report.[0-9]*.[0-9]*.[0-9]*.[0-9]*.json
+
+# Runtime data
+pids
+*.pid
+*.seed
+*.pid.lock
+
+# Directory for instrumented libs generated by jscoverage/JSCover
+lib-cov
+
+# Coverage directory used by tools like istanbul
+coverage
+*.lcov
+
+# nyc test coverage
+.nyc_output
+
+# Grunt intermediate storage (https://gruntjs.com/creating-plugins#storing-task-files)
+.grunt
+
+# Bower dependency directory (https://bower.io/)
+bower_components
+
+# node-waf configuration
+.lock-wscript
+
+# Compiled binary addons (https://nodejs.org/api/addons.html)
+build/Release
+
+# Dependency directories
+node_modules/
+jspm_packages/
+
+# Snowpack dependency directory (https://snowpack.dev/)
+web_modules/
+
+# TypeScript cache
+*.tsbuildinfo
+
+# Optional npm cache directory
+.npm
+
+# Optional eslint cache
+.eslintcache
+
+# Optional stylelint cache
+.stylelintcache
+
+# Microbundle cache
+.rpt2_cache/
+.rts2_cache_cjs/
+.rts2_cache_es/
+.rts2_cache_umd/
+
+# Optional REPL history
+.node_repl_history
+
+# Output of 'npm pack'
+*.tgz
+
+# Yarn Integrity file
+.yarn-integrity
+
+# dotenv environment variable files
+.env
+.env.development.local
+.env.test.local
+.env.production.local
+.env.local
+
+# parcel-bundler cache (https://parceljs.org/)
+.cache
+.parcel-cache
+
+# Next.js build output
+.next
+out
+
+# Nuxt.js build / generate output
+.nuxt
+dist
+
+# Gatsby files
+.cache/
+# Comment in the public line in if your project uses Gatsby and not Next.js
+# https://nextjs.org/blog/next-9-1#public-directory-support
+# public
+
+# vuepress build output
+.vuepress/dist
+
+# vuepress v2.x temp and cache directory
+.temp
+
+# Docusaurus cache and generated files
+.docusaurus
+
+# Serverless directories
+.serverless/
+
+# FuseBox cache
+.fusebox/
+
+# DynamoDB Local files
+.dynamodb/
+
+# TernJS port file
+.tern-port
+
+# Stores VSCode versions used for testing VSCode extensions
+.vscode-test
+
+# yarn v2
+.yarn/cache
+.yarn/unplugged
+.yarn/build-state.yml
+.yarn/install-state.gz
+.pnp.*
+
+### Node Patch ###
+# Serverless Webpack directories
+.webpack/
+
+# Optional stylelint cache
+
+# SvelteKit build / generate output
+.svelte-kit
+
+### OSX ###
+# General
+.DS_Store
+.AppleDouble
+.LSOverride
+
+# Icon must end with two \r
+Icon
+
+
+# Thumbnails
+._*
+
+# Files that might appear in the root of a volume
+.DocumentRevisions-V100
+.fseventsd
+.Spotlight-V100
+.TemporaryItems
+.Trashes
+.VolumeIcon.icns
+.com.apple.timemachine.donotpresent
+
+# Directories potentially created on remote AFP share
+.AppleDB
+.AppleDesktop
+Network Trash Folder
+Temporary Items
+.apdisk
+
+### Windows ###
+# Windows thumbnail cache files
+Thumbs.db
+Thumbs.db:encryptable
+ehthumbs.db
+ehthumbs_vista.db
+
+# Dump file
+*.stackdump
+
+# Folder config file
+[Dd]esktop.ini
+
+# Recycle Bin used on file shares
+$RECYCLE.BIN/
+
+# Windows Installer files
+*.cab
+*.msi
+*.msix
+*.msm
+*.msp
+
+# Windows shortcuts
+*.lnk
+
+# End of https://www.toptal.com/developers/gitignore/api/node,osx,linux,windows