create-jen-app 0.1.0

package/templates/static/node_modules/sirv/readme.md

@@ -0,0 +1,238 @@
+# sirv ![CI](https://github.com/lukeed/sirv/workflows/CI/badge.svg)
+
+> The optimized and lightweight middleware for serving requests to static assets
+
+You may use `sirv` as a *very* fast and lightweight alternative to [`serve-static`](https://www.npmjs.com/package/serve-static).
+
+The massive performance advantage over `serve-static` is explained by **not** relying on the file system for existence checks on every request. These are expensive interactions and must be avoided whenever possible! Instead, when not in "dev" mode, `sirv` performs all its file-system operations upfront and then relies on its cache for future operations.
+
+This middleware will work out of the box for [Polka](https://github.com/lukeed/polka), Express, and other Express-like frameworks. It will also work with the native `http`, `https` and `http2` modules. It requires _very_ little effort to modify/wrap it for servers that don't accept the `(req, res, next)` signature.
+
+:bulb: For a feature-complete CLI application, check out the sibling [`sirv-cli`](https://github.com/lukeed/sirv/tree/master/packages/sirv-cli) package as an alternative to [`zeit/serve`](https://github.com/zeit/serve)~!
+
+## Install
+
+```
+$ npm install --save sirv
+```
+
+
+## Usage
+
+```js
+const sirv = require('sirv');
+const polka = require('polka');
+const compress = require('compression')();
+
+// Init `sirv` handler
+const assets = sirv('public', {
+  maxAge: 31536000, // 1Y
+  immutable: true
+});
+
+polka()
+  .use(compress, assets)
+  .use('/api', require('./api'))
+  .listen(3000, err => {
+    if (err) throw err;
+    console.log('> Ready on localhost:3000~!');
+  });
+```
+
+
+## API
+
+### sirv(dir, opts={})
+
+Returns: `Function`
+
+The returned function is a middleware in the standard Express-like signature: `(req, res, next)`, where `req` is the [`http.IncomingMessage`](https://nodejs.org/api/http.html#http_class_http_incomingmessage), `res` is the [`http.ServerResponse`](https://nodejs.org/dist/latest-v9.x/docs/api/http.html#http_class_http_serverresponse), and `next` (in this case) is the function to call if no file was found for the given path.
+
+When defined, a `next()` callback is always called _instead of_ the [`opts.onNoMatch`](#optsonnomatch) callback. However, unlike `onNoMatch`, your `next()` is given no arguments.
+
+#### dir
+Type: `String`<br>
+Default: `.`
+
+The directory from which to read and serve assets. It is resolved to an absolute path &mdash; you must provide an absolute path yourself if `process.cwd()` is not the correct assumption.
+
+#### opts.dev
+Type: `Boolean`<br>
+Default: `false`
+
+Enable "dev" mode, which disables/skips caching. Instead, `sirv` will traverse the file system ***on every request***.
+
+Additionally, `dev` mode will ignore `maxAge` and `immutable` as these options generate a production-oriented `Cache-Control` header value.
+
+> **Important:** Do not use `dev` mode in production!
+
+#### opts.etag
+Type: `Boolean`<br>
+Default: `false`
+
+Generate and attach an `ETag` header to responses.
+
+> **Note:** If an incoming request's [`If-None-Match` header](https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/If-None-Match) matches the `ETag` value, a `304` response is given.
+
+#### opts.dotfiles
+Type: `Boolean`<br>
+Default: `false`
+
+Allow requests to dotfiles (files or directories beginning with a `.`).
+
+> **Note:** Requests to [`/.well-known/*`](https://tools.ietf.org/html/rfc8615) are always allowed.
+
+#### opts.extensions
+Type: `Array<String>`<br>
+Default: `['html', 'htm']`
+
+The file extension fallbacks to check for if a pathame is not initially found. For example, if a `/login` request cannot find a `login` filename, it will then look for `login.html` and `login.htm` before giving up~!
+
+> **Important:** Actually, `sirv` will **also** look for `login/index.html` and `login/index.htm` before giving up.
+
+#### opts.gzip
+Type: `Boolean`<br>
+Default: `false`
+
+Determine if `sirv` look for **precompiled** `*.gz` files.<br>
+Must be enabled _and_ the incoming request's [`Accept Encoding`](https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/Accept-Encoding) must include "gzip" in order for `sirv` to search for the gzip'd alternative.
+
+> **Note:** The `.gz` assumption also applies to the `opts.extensions` list.
+
+```js
+// NOTE: PSEUDO CODE
+// Showing lookup logic
+
+// Request: [Accept-Encoding: gzip] "/foobar.jpg"
+lookup([
+  '/foobar.jpg.gz', '/foobar.jpg',
+  '/foobar.jpg.html.gz', '/foobar.jpg/index.html.gz',
+  '/foobar.jpg.htm.gz', '/foobar.jpg/index.htm.gz',
+  '/foobar.jpg.html', '/foobar.jpg/index.html',
+  '/foobar.jpg.htm', '/foobar.jpg/index.htm',
+]);
+
+// Request: [Accept-Encoding: gzip] "/"
+lookup([
+  '/index.html.gz',
+  '/index.htm.gz',
+  '/index.html',
+  '/index.htm',
+]);
+```
+
+
+#### opts.brotli
+Type: `Boolean`<br>
+Default: `false`
+
+Determine if `sirv` look for **precompiled** `*.br` files.<br>
+Must be enabled _and_ the incoming request's [`Accept Encoding`](https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/Accept-Encoding) must include either "br" or "brotli" in order for `sirv` to search for the brotli-compressed alternative.
+
+> **Note:** The `.br` assumption also applies to the `opts.extensions` list.
+
+When both `opts.broli` and `opts.gzip` are enabled &mdash; and all conditions are equal &mdash; then the brotli variant always takes priority.
+
+```js
+// NOTE: PSEUDO CODE
+// Showing lookup logic
+
+// Request: [Accept-Encoding: br] "/foobar.jpg"
+lookup([
+  '/foobar.jpg.br', '/foobar.jpg',
+  '/foobar.jpg.html.br', '/foobar.jpg/index.html.br',
+  '/foobar.jpg.htm.br', '/foobar.jpg/index.htm.br',
+  '/foobar.jpg.html', '/foobar.jpg/index.html',
+  '/foobar.jpg.htm', '/foobar.jpg/index.htm',
+]);
+
+// Request: [Accept-Encoding: br,gz] "/"
+lookup([
+  '/index.html.br'
+  '/index.htm.br'
+  '/index.html.gz'
+  '/index.htm.gz'
+  '/index.html'
+  '/index.htm'
+]);
+```
+
+#### opts.maxAge
+Type: `Number`<br>
+Default: `undefined`
+
+Enables the `Cache-Control` header on responses and sets the `max-age` value (in seconds).<br>
+For example, `maxAge: 31536000` is equivalent to one year.
+
+#### opts.immutable
+Type: `Boolean`<br>
+Default: `false`
+
+Appends the [`immutable` directive](https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/Cache-Control#Revalidation_and_reloading) on your `Cache-Control` header, used for uniquely-named assets that will not change!
+
+> **Important:** Will only work if `opts.maxAge` has a value defined!
+
+#### opts.single
+Type: `Boolean` or `String`<br>
+Default: `false`
+
+Treat the directory as a single-page application.
+
+When `true`, the directory's index page (default `index.html`) will be sent if the request asset does not exist.<br>
+You may pass a `string` value to use a file _instead of_ `index.html` as your fallback.
+
+For example, if "/about" is requested but no variants of that file exist, then the response for "/" is sent instead:
+
+```js
+// Note: This is psuedo code to illustrate what's happening
+
+// Request: "/about"
+let file = find(['/about', '/about.html', '/about.htm', '/about/index.html', '/about.htm']);
+if (file) {
+  send(file);
+} else if (opts.single === true) {
+  file = find(['/', '/index.html', '/index.htm']);
+  send(file);
+} else if (typeof opts.single === 'string') {
+  file = find([opts.single]);
+  send(file);
+} else {
+  // next() or 404
+}
+```
+
+#### opts.ignores
+Type: `false` or `Array<String | RegExp>`
+
+Specify paths/patterns that should ignore the fallback behavior that `opts.single` provides.
+
+By default, any asset-like path (URLs that end with an extension) will be ignored. This means that, for example, if `/foobar.jpg` is not found, a `404` response is sent instead of the `index.html` fallback.
+
+Additionally, any `/.well-known/*` pathname ignores the fallback – as do all other dotfile requests when `opts.dotfiles` is enabled.
+
+Any string value(s) will be passed through `new RegExp(value, 'i')` directly.
+
+Finally, you may set `ignores: false` to disable ***all*** ignores, including the defaults. Put differently, this will fallback ***all*** unknown pathnames to your `index.html` (or custom `opts.single` value).
+
+> **Important:** Only has an effect if `opts.single` is enabled.
+
+#### opts.onNoMatch
+Type: `Function`
+
+A custom function to run if a file cannot be found for a given request. <br>By default, `sirv` will send a basic `(404) Not found` response.
+
+The function receives the current `req <IncomingMessage>, res <ServerResponse>` pair for as its two arguments.
+
+> **Note:** This won't run if a `next` callback has been provided to the middleware; see [`sirv`](#sirvdir-opts) description.
+
+#### opts.setHeaders
+Type: `Function`
+
+A custom function to append or change any headers on the outgoing response. There is no default.
+
+Its signature is `(res, pathname, stats)`, where `res` is the `ServerResponse`, `pathname` is incoming request path (stripped of queries), and `stats` is the file's result from [`fs.statSync`](https://nodejs.org/api/fs.html#fs_fs_statsync_path).
+
+
+## License
+
+MIT © [Luke Edwards](https://lukeed.com)

package/templates/static/node_modules/totalist/dist/index.js

@@ -0,0 +1,24 @@
+const { join, resolve } = require('path');
+const { readdir, stat } = require('fs');
+const { promisify } = require('util');
+
+const toStats = promisify(stat);
+const toRead = promisify(readdir);
+
+async function totalist(dir, callback, pre='') {
+	dir = resolve('.', dir);
+	await toRead(dir).then(arr => {
+		return Promise.all(
+			arr.map(str => {
+				let abs = join(dir, str);
+				return toStats(abs).then(stats => {
+					return stats.isDirectory()
+						? totalist(abs, callback, join(pre, str))
+						: callback(join(pre, str), abs, stats)
+				});
+			})
+		);
+	});
+}
+
+exports.totalist = totalist;

package/templates/static/node_modules/totalist/dist/index.mjs

@@ -0,0 +1,22 @@
+import { join, resolve } from 'path';
+import { readdir, stat } from 'fs';
+import { promisify } from 'util';
+
+const toStats = promisify(stat);
+const toRead = promisify(readdir);
+
+export async function totalist(dir, callback, pre='') {
+	dir = resolve('.', dir);
+	await toRead(dir).then(arr => {
+		return Promise.all(
+			arr.map(str => {
+				let abs = join(dir, str);
+				return toStats(abs).then(stats => {
+					return stats.isDirectory()
+						? totalist(abs, callback, join(pre, str))
+						: callback(join(pre, str), abs, stats)
+				});
+			})
+		);
+	});
+}

package/templates/static/node_modules/totalist/index.d.ts

@@ -0,0 +1,3 @@
+import { Stats } from 'fs';
+export type Caller = (relPath: string, absPath: string, stats: Stats) => any;
+export function totalist(dir: string, callback: Caller, prefix?: string): Promise<void>;

package/templates/static/node_modules/totalist/license

@@ -0,0 +1,21 @@
+The MIT License (MIT)
+
+Copyright (c) Luke Edwards <luke.edwards05@gmail.com> (lukeed.com)
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in
+all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
+THE SOFTWARE.

package/templates/static/node_modules/totalist/package.json

@@ -0,0 +1,55 @@
+{
+  "name": "totalist",
+  "version": "3.0.1",
+  "repository": "lukeed/totalist",
+  "description": "A tiny (195B to 220B) utility to recursively list all (total) files in a directory",
+  "module": "dist/index.mjs",
+  "main": "dist/index.js",
+  "types": "index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./index.d.ts",
+      "import": "./dist/index.mjs",
+      "require": "./dist/index.js"
+    },
+    "./sync": {
+      "types": "./sync/index.d.ts",
+      "import": "./sync/index.mjs",
+      "require": "./sync/index.js"
+    }
+  },
+  "license": "MIT",
+  "files": [
+    "index.d.ts",
+    "dist",
+    "sync"
+  ],
+  "author": {
+    "name": "Luke Edwards",
+    "email": "luke.edwards05@gmail.com",
+    "url": "https://lukeed.com"
+  },
+  "engines": {
+    "node": ">=6"
+  },
+  "keywords": [
+    "list",
+    "recursive",
+    "files",
+    "glob",
+    "tree"
+  ],
+  "scripts": {
+    "build": "bundt",
+    "test": "uvu -r esm test -i fixtures"
+  },
+  "modes": {
+    "sync": "src/sync.js",
+    "default": "src/async.js"
+  },
+  "devDependencies": {
+    "bundt": "1.1.1",
+    "esm": "3.2.25",
+    "uvu": "0.3.3"
+  }
+}

package/templates/static/node_modules/totalist/readme.md

@@ -0,0 +1,109 @@
+# totalist [![build status](https://badgen.now.sh/github/status/lukeed/totalist)](https://github.com/lukeed/totalist/actions) [![codecov](https://badgen.now.sh/codecov/c/github/lukeed/totalist)](https://codecov.io/gh/lukeed/totalist)
+
+> A tiny (195B to 224B) utility to recursively list all (total) files in a directory
+
+Traverse a directory recursively, running a function for **every file** found.
+
+With this module, you easily apply custom logic to decide which file(s) to process without worrying about accidentally accessing a directory or making repeat `fs.Stats` requests.
+
+## Install
+
+```
+$ npm install --save totalist
+```
+
+
+## Modes
+
+There are two "versions" of `totalist` available:
+
+#### "async"
+> **Node.js:** >= 8.x<br>
+> **Size (gzip):** 220 bytes<br>
+> **Availability:** [CommonJS](https://unpkg.com/totalist/dist/index.js), [ES Module](https://unpkg.com/totalist/dist/index.mjs)
+
+This is the primary/default mode. It makes use of `async`/`await` and [`util.promisify`](https://nodejs.org/api/util.html#util_util_promisify_original).
+
+#### "sync"
+> **Node.js:** >= 6.x<br>
+> **Size (gzip):** 195 bytes<br>
+> **Availability:** [CommonJS](https://unpkg.com/totalist/sync/index.js), [ES Module](https://unpkg.com/totalist/sync/index.mjs)
+
+This is the opt-in mode, ideal for scenarios where `async` usage cannot be supported.
+
+
+## Usage
+
+***Selecting a Mode***
+
+```js
+// import via npm module
+import { totalist } from 'totalist';
+import { totalist } from 'totalist/sync';
+```
+
+***Example Usage***
+
+```js
+import { totalist } from 'totalist/sync';
+
+const styles = new Set();
+const scripts = new Set();
+
+totalist('src', (name, abs, stats) => {
+  if (/\.js$/.test(name)) {
+    scripts.add(abs);
+    if (stats.size >= 100e3) {
+      console.warn(`[WARN] "${name}" might cause performance issues (${stats.size})`);
+    }
+  } else if (/\.css$/.test(name)) {
+    styles.add(abs);
+  }
+});
+
+console.log([...scripts]);
+//=> [..., '/Users/lukeed/.../src/path/to/example.css', ...]
+```
+
+
+## API
+
+### totalist(dir, callback)
+Returns: `void`
+
+> **Important:** The "async" usage must be `await`ed or included within a Promise chain.
+
+#### dir
+Type: `string`<br>
+Required: `true`
+
+The directory to traverse.
+
+This may be a relative _or_ an absolute path.
+
+> **Note**: Node.js will assume a relative path is meant to be resolved from the current location (`process.cwd()`).
+
+#### callback
+Type: `Function`<br>
+Required: `true`
+
+The callback function to run for _every_ file.
+
+The function receives three parameters:
+
+##### relPath
+Type: `String`<br>
+The path _relative to_ the initial `dir` value you provided.
+
+##### absPath
+Type: `String`<br>
+The absolute path of the file.
+
+##### stats
+Type: `fs.Stats`<br>
+The [`fs.Stats`](https://nodejs.org/api/fs.html#fs_class_fs_stats) object for the file.
+
+
+## License
+
+MIT © [Luke Edwards](https://lukeed.com)

package/templates/static/node_modules/totalist/sync/index.d.ts

@@ -0,0 +1,3 @@
+import { Stats } from 'fs';
+export type Caller = (relPath: string, absPath: string, stats: Stats) => any;
+export function totalist(dir: string, callback: Caller, prefix?: string): void;

package/templates/static/node_modules/totalist/sync/index.js

@@ -0,0 +1,17 @@
+const { join, resolve } = require('path');
+const { readdirSync, statSync } = require('fs');
+
+function totalist(dir, callback, pre='') {
+	dir = resolve('.', dir);
+	let arr = readdirSync(dir);
+	let i=0, abs, stats;
+	for (; i < arr.length; i++) {
+		abs = join(dir, arr[i]);
+		stats = statSync(abs);
+		stats.isDirectory()
+			? totalist(abs, callback, join(pre, arr[i]))
+			: callback(join(pre, arr[i]), abs, stats);
+	}
+}
+
+exports.totalist = totalist;

package/templates/static/node_modules/totalist/sync/index.mjs

@@ -0,0 +1,15 @@
+import { join, resolve } from 'path';
+import { readdirSync, statSync } from 'fs';
+
+export function totalist(dir, callback, pre='') {
+	dir = resolve('.', dir);
+	let arr = readdirSync(dir);
+	let i=0, abs, stats;
+	for (; i < arr.length; i++) {
+		abs = join(dir, arr[i]);
+		stats = statSync(abs);
+		stats.isDirectory()
+			? totalist(abs, callback, join(pre, arr[i]))
+			: callback(join(pre, arr[i]), abs, stats);
+	}
+}

package/templates/static/node_modules/typescript/bin/tsc

@@ -0,0 +1,2 @@
+#!/usr/bin/env node
+require('../lib/tsc.js')

package/templates/static/node_modules/typescript/bin/tsserver

@@ -0,0 +1,2 @@
+#!/usr/bin/env node
+require('../lib/tsserver.js')