Big Bang

.gitignore

@@ -0,0 +1,195 @@
+# ---> JetBrains
+# Covers JetBrains IDEs: IntelliJ, RubyMine, PhpStorm, AppCode, PyCharm, CLion, Android Studio, WebStorm and Rider
+# Reference: https://intellij-support.jetbrains.com/hc/en-us/articles/206544839
+
+# User-specific stuff
+.idea/**/workspace.xml
+.idea/**/tasks.xml
+.idea/**/usage.statistics.xml
+.idea/**/dictionaries
+.idea/**/shelf
+
+# Generated files
+.idea/**/contentModel.xml
+
+# Sensitive or high-churn files
+.idea/**/dataSources/
+.idea/**/dataSources.ids
+.idea/**/dataSources.local.xml
+.idea/**/sqlDataSources.xml
+.idea/**/dynamic.xml
+.idea/**/uiDesigner.xml
+.idea/**/dbnavigator.xml
+
+# Gradle
+.idea/**/gradle.xml
+.idea/**/libraries
+
+# Gradle and Maven with auto-import
+# When using Gradle or Maven with auto-import, you should exclude module files,
+# since they will be recreated, and may cause churn.  Uncomment if using
+# auto-import.
+# .idea/artifacts
+# .idea/compiler.xml
+# .idea/jarRepositories.xml
+# .idea/modules.xml
+# .idea/*.iml
+# .idea/modules
+# *.iml
+# *.ipr
+
+# CMake
+cmake-build-*/
+
+# Mongo Explorer plugin
+.idea/**/mongoSettings.xml
+
+# File-based project format
+*.iws
+
+# IntelliJ
+out/
+
+# mpeltonen/sbt-idea plugin
+.idea_modules/
+
+# JIRA plugin
+atlassian-ide-plugin.xml
+
+# Cursive Clojure plugin
+.idea/replstate.xml
+
+# Crashlytics plugin (for Android Studio and IntelliJ)
+com_crashlytics_export_strings.xml
+crashlytics.properties
+crashlytics-build.properties
+fabric.properties
+
+# Editor-based Rest Client
+.idea/httpRequests
+
+# Android studio 3.1+ serialized cache file
+.idea/caches/build_file_checksums.ser
+
+# ---> Node
+# Logs
+logs
+*.log
+npm-debug.log*
+yarn-debug.log*
+yarn-error.log*
+lerna-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
+
+# 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 variables file
+.env
+.env.test
+
+# 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
+
+# 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.*
+
+/lib
+/exbuild
+
+*.sqlite

.idea/.gitignore

@@ -0,0 +1,8 @@
+# Default ignored files
+/shelf/
+/workspace.xml
+# Datasource local storage ignored files
+/dataSources/
+/dataSources.local.xml
+# Editor-based HTTP Client requests
+/httpRequests/

.idea/codeStyles/Project.xml

@@ -0,0 +1,40 @@
+<component name="ProjectCodeStyleConfiguration">
+  <code_scheme name="Project" version="173">
+    <JSCodeStyleSettings version="0">
+      <option name="USE_SEMICOLON_AFTER_STATEMENT" value="false" />
+      <option name="FORCE_SEMICOLON_STYLE" value="true" />
+      <option name="USE_DOUBLE_QUOTES" value="false" />
+      <option name="FORCE_QUOTE_STYlE" value="true" />
+      <option name="ENFORCE_TRAILING_COMMA" value="WhenMultiline" />
+      <option name="OBJECT_LITERAL_WRAP" value="2" />
+    </JSCodeStyleSettings>
+    <TypeScriptCodeStyleSettings version="0">
+      <option name="USE_SEMICOLON_AFTER_STATEMENT" value="false" />
+      <option name="FORCE_SEMICOLON_STYLE" value="true" />
+      <option name="USE_DOUBLE_QUOTES" value="false" />
+      <option name="FORCE_QUOTE_STYlE" value="true" />
+      <option name="ENFORCE_TRAILING_COMMA" value="WhenMultiline" />
+      <option name="OBJECT_LITERAL_WRAP" value="2" />
+    </TypeScriptCodeStyleSettings>
+    <codeStyleSettings language="JavaScript">
+      <option name="INDENT_CASE_FROM_SWITCH" value="false" />
+      <option name="ALIGN_MULTILINE_PARAMETERS" value="false" />
+      <option name="ALIGN_MULTILINE_FOR" value="false" />
+      <option name="METHOD_CALL_CHAIN_WRAP" value="2" />
+      <option name="IF_BRACE_FORCE" value="3" />
+      <option name="DOWHILE_BRACE_FORCE" value="3" />
+      <option name="WHILE_BRACE_FORCE" value="3" />
+      <option name="FOR_BRACE_FORCE" value="3" />
+    </codeStyleSettings>
+    <codeStyleSettings language="TypeScript">
+      <option name="INDENT_CASE_FROM_SWITCH" value="false" />
+      <option name="ALIGN_MULTILINE_PARAMETERS" value="false" />
+      <option name="ALIGN_MULTILINE_FOR" value="false" />
+      <option name="METHOD_CALL_CHAIN_WRAP" value="2" />
+      <option name="IF_BRACE_FORCE" value="3" />
+      <option name="DOWHILE_BRACE_FORCE" value="3" />
+      <option name="WHILE_BRACE_FORCE" value="3" />
+      <option name="FOR_BRACE_FORCE" value="3" />
+    </codeStyleSettings>
+  </code_scheme>
+</component>

.idea/codeStyles/codeStyleConfig.xml

@@ -0,0 +1,5 @@
+<component name="ProjectCodeStyleConfiguration">
+  <state>
+    <option name="USE_PER_PROJECT_SETTINGS" value="true" />
+  </state>
+</component>

.idea/dataSources.xml

@@ -0,0 +1,12 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<project version="4">
+  <component name="DataSourceManagerImpl" format="xml" multifile-model="true">
+    <data-source source="LOCAL" name="p5x.sqlite" uuid="a9dd3c82-945d-4e58-82b1-e9746847a0ab">
+      <driver-ref>sqlite.xerial</driver-ref>
+      <synchronize>true</synchronize>
+      <jdbc-driver>org.sqlite.JDBC</jdbc-driver>
+      <jdbc-url>jdbc:sqlite:p5x.sqlite</jdbc-url>
+      <working-dir>$ProjectFileDir$</working-dir>
+    </data-source>
+  </component>
+</project>

.idea/extollo.iml

@@ -0,0 +1,10 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<module type="WEB_MODULE" version="4">
+  <component name="NewModuleRootManager">
+    <content url="file://$MODULE_DIR$" />
+    <orderEntry type="inheritedJdk" />
+    <orderEntry type="sourceFolder" forTests="false" />
+    <orderEntry type="module" module-name="di" />
+    <orderEntry type="module" module-name="lib" />
+  </component>
+</module>

.idea/modules.xml

@@ -0,0 +1,10 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<project version="4">
+  <component name="ProjectModuleManager">
+    <modules>
+      <module fileurl="file://$PROJECT_DIR$/../di/.idea/di.iml" filepath="$PROJECT_DIR$/../di/.idea/di.iml" />
+      <module fileurl="file://$PROJECT_DIR$/.idea/extollo.iml" filepath="$PROJECT_DIR$/.idea/extollo.iml" />
+      <module fileurl="file://$PROJECT_DIR$/../extollo_lib/.idea/lib.iml" filepath="$PROJECT_DIR$/../extollo_lib/.idea/lib.iml" />
+    </modules>
+  </component>
+</project>

.idea/vcs.xml

@@ -0,0 +1,6 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<project version="4">
+  <component name="VcsDirectoryMappings">
+    <mapping directory="" vcs="Git" />
+  </component>
+</project>

LICENSE

@@ -0,0 +1,19 @@
+Copyright © 2021 Garrett Mills
+
+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.

README.md

@@ -0,0 +1,2 @@
+# `proxmox-k8s/control-server`
+

ex

@@ -0,0 +1,137 @@
+#!/bin/bash
+
+ENV_NODE="$(which node)"
+ENV_PNPM="$(which pnpm)"
+
+LOGO="     _
+    / /\       ______      _        _ _
+   / /  \     |  ____|    | |      | | |
+  / / /\ \    | |__  __  _| |_ ___ | | | ___
+ / / /\ \ \   |  __| \ \/ / __/ _ \| | |/ _ \\
+/ / /  \ \_\  | |____ >  <| || (_) | | | (_) |
+\/_/    \/_/  |______/_/\_\\\__\___/|_|_|\___/
+"
+
+# Author: Tasos Latsas
+
+# spinner.sh
+#
+# Display an awesome 'spinner' while running your long shell commands
+#
+# Do *NOT* call _spinner function directly.
+# Use {start,stop}_spinner wrapper functions
+
+# usage:
+#   1. source this script in your's
+#   2. start the spinner:
+#       start_spinner [display-message-here]
+#   3. run your command
+#   4. stop the spinner:
+#       stop_spinner [your command's exit status]
+#
+# Also see: test.sh
+
+
+function _spinner() {
+    # $1 start/stop
+    #
+    # on start: $2 display message
+    # on stop : $2 process exit status
+    #           $3 spinner function pid (supplied from stop_spinner)
+
+    local on_success="DONE"
+    local on_fail="FAIL"
+    local white="\e[1;37m"
+    local green="\e[1;32m"
+    local red="\e[1;31m"
+    local nc="\e[0m"
+
+    case $1 in
+        start)
+            # calculate the column where spinner and status msg will be displayed
+            let column=$(tput cols)-${#2}-8
+            # display message and position the cursor in $column column
+            echo -ne ${2}
+            printf "%${column}s"
+
+            # start spinner
+            i=1
+            sp='\|/-'
+            delay=${SPINNER_DELAY:-0.15}
+
+            while :
+            do
+                printf "\b${sp:i++%${#sp}:1}"
+                sleep $delay
+            done
+            ;;
+        stop)
+            if [[ -z ${3} ]]; then
+                echo "spinner is not running.."
+                exit 1
+            fi
+
+            kill $3 > /dev/null 2>&1
+
+            # inform the user uppon success or failure
+            echo -en "\b["
+            if [[ $2 -eq 0 ]]; then
+                echo -en "${green}${on_success}${nc}"
+            else
+                echo -en "${red}${on_fail}${nc}"
+            fi
+            echo -e "]"
+            ;;
+        *)
+            echo "invalid argument, try {start/stop}"
+            exit 1
+            ;;
+    esac
+}
+
+function start_spinner {
+    # $1 : msg to display
+    _spinner "start" "${1}" &
+    # set global spinner pid
+    _sp_pid=$!
+    disown
+}
+
+function stop_spinner {
+    # $1 : command exit status
+    _spinner "stop" $1 $_sp_pid
+    unset _sp_pid
+}
+
+function echoRun() {
+  echo ""
+  echo "+ $@"
+  echo ""
+  "$@"
+  echo ""
+}
+
+if [ ! -d "./node_modules" ]; then
+  echo "$LOGO"
+  echo "+----------------------------------------+"
+  echo "| Docs: https://extollo.garrettmills.dev |"
+  echo "+----------------------------------------+"
+  echo ""
+  echo "Welcome to Extollo! Let's set things up for the first time..."
+
+  if [ ! -x "$ENV_PNPM" ]; then
+    echo "Please install PNPM to use Extollo."
+  fi
+
+  echoRun "$ENV_PNPM" i
+
+  if [ ! -f "./.env" ]; then
+    echoRun cp example.env .env
+  fi
+
+  echo ""
+  echo ""
+  printf "\033[32m✓\033[39m Looks like you're all set up! Run this command again to access the Extollo CLI.\n"
+else
+  "$ENV_PNPM" cli "$@"
+fi

example.env

@@ -0,0 +1,3 @@
+DEBUG_MODE=true
+EXTOLLO_LOGGING_LEVEL=6
+P5X_SQLITE_PATH=p5x.sqlite

package.json

@@ -0,0 +1,48 @@
+{
+  "name": "@extollo/extollo",
+  "version": "0.1.0",
+  "description": "The framework lifts up your code.",
+  "main": "lib/index.js",
+  "types": "lib/index.d.ts",
+  "directories": {
+    "lib": "lib"
+  },
+  "dependencies": {
+    "@atao60/fse-cli": "^0.1.7",
+    "@extollo/lib": "^0.14.10",
+    "@types/node": "^18.15.11",
+    "copyfiles": "^2.4.1",
+    "feed": "^4.2.2",
+    "gotify": "^1.1.0",
+    "rimraf": "^3.0.2",
+    "ts-expose-internals": "^4.5.4",
+    "ts-node": "^10.9.0",
+    "ts-patch": "^2.0.1",
+    "ts-to-zod": "^1.8.0",
+    "typescript": "^4.3.2",
+    "zod": "^3.11.6"
+  },
+  "scripts": {
+    "test": "echo \"Error: no test specified\" && exit 1",
+    "app": "ts-node src/index.ts",
+    "cli": "ts-node src/cli.ts",
+    "watch": "nodemon --ext js,pug,ts --watch src --exec 'ts-node src/index.ts'",
+    "clean": "rimraf lib",
+    "prepare": "pnpm run build",
+    "build": "pnpm run clean && tsc -p tsconfig.json && fse copy --all --dereference --preserveTimestamps --keepExisting=false --quiet --errorOnExist=false src/app/resources lib/app/resources"
+  },
+  "files": [
+    "lib/**/*"
+  ],
+  "prepare": "npm run build",
+  "postversion": "git push && git push --tags",
+  "repository": {
+    "type": "git",
+    "url": "https://code.garrettmills.dev/extollo/extollo"
+  },
+  "author": "garrettmills <shout@garrettmills.dev>",
+  "license": "MIT",
+  "devDependencies": {
+    "nodemon": "^2.0.19"
+  }
+}

src/Units.extollo.ts

@@ -0,0 +1,48 @@
+import {
+    Config,
+    Controllers,
+    HTTPServer,
+    Files,
+    Middlewares,
+    Routing,
+    Unit,
+    Database,
+    Models,
+    CommandLine,
+    Internationalization,
+    Authentication,
+    Discovery,
+    ValidationUnit,
+    Migrations,
+    Queueables,
+    Redis,
+    Bus,
+    WebsocketServer,
+} from '@extollo/lib'
+import {AppUnit} from './app/AppUnit'
+
+Error.stackTraceLimit = 500
+
+export const Units = [
+    Config,
+    // Redis,
+    Queueables,
+    Bus,
+    // ValidationUnit,
+    Files,
+    CommandLine,
+    Controllers,
+    Middlewares,
+    Database,
+    Models,
+    Migrations,
+    Internationalization,
+    Authentication,
+
+    AppUnit,
+
+    Routing,
+    Discovery,
+    HTTPServer,
+    // WebsocketServer,
+] as (typeof Unit)[]

src/app/AppUnit.ts

@@ -0,0 +1,9 @@
+import {ORMUser, Singleton, Unit} from '@extollo/lib'
+import {User} from './models/User.model'
+
+@Singleton()
+export class AppUnit extends Unit {
+    async up(): Promise<void> {
+        this.container().registerStaticOverride(ORMUser, User)
+    }
+}

src/app/configs/app.config.ts

@@ -0,0 +1,5 @@
+import { env } from '@extollo/lib'
+
+export default {
+    name: env('APP_NAME', 'P5X'),
+}

src/app/configs/auth.config.ts

@@ -0,0 +1,21 @@
+import {AuthenticationConfig, CoreIDLoginProvider, OAuth2LoginProviderConfig, ORMUserRepository, env} from '@extollo/lib'
+
+const authConfig: AuthenticationConfig = {
+    storage: ORMUserRepository,
+    providers: {
+        coreid: {
+            driver: CoreIDLoginProvider,
+            config: {
+                default: true,
+                displayName: 'Starship CoreID',
+                clientId: env('COREID_CLIENT_ID'),
+                clientSecret: env('COREID_CLIENT_SECRET'),
+                loginUrl: env('COREID_BASE', '') + '/auth/service/oauth2/authorize?client_id=%c&redirect_uri=%r',
+                tokenUrl: env('COREID_BASE', '') + '/auth/service/oauth2/redeem',
+                userUrl: env('COREID_BASE', '') + '/api/v1/auth/users/me',
+            } as OAuth2LoginProviderConfig,
+        }
+    },
+}
+
+export default authConfig

src/app/configs/database.config.ts

@@ -0,0 +1,10 @@
+import { env } from '@extollo/lib'
+
+export default {
+    connections: {
+        default: {
+            dialect: 'sqlite',
+            filename: env('P5X_SQLITE_PATH', 'p5x.sqlite'),
+        },
+    },
+}

src/app/configs/lang/common.config.ts

@@ -0,0 +1,5 @@
+import { env } from "@extollo/lib"
+
+export default {
+    app_name: env('APP_NAME', 'Extollo'),
+}

src/app/configs/lang/en_US.config.ts

@@ -0,0 +1,6 @@
+import {env} from '@extollo/lib'
+
+export default {
+    welcome_to_extollo: 'Welcome to Extollo!',
+    viewed_page_num_times: 'You have viewed this page :num: times.',
+}

src/app/configs/oauth2.config.ts

@@ -0,0 +1,24 @@
+import {OAuth2Client, OAuth2Scope, env, uuid4} from '@extollo/lib'
+
+export default {
+    secret: env('OAUTH2_SECRET'),
+    scopes: {
+        'user-info': {
+            id: 'user-info',
+            name: 'user-info',
+            description: 'access basic information about your account',
+        },
+    } as {[key: string]: OAuth2Scope},
+    clients: {
+        'test-1': {
+            id: 'test-1',
+            display: 'Test 1',
+            secret: env('TEST_CLIENT_SECRET', uuid4()),
+            allowedFlows: ['code'],
+            allowedScopeIds: ['user-info'],
+            allowedRedirectUris: [
+                'http://localhost:1234/callback',
+            ],
+        },
+    } as {[key: string]: OAuth2Client},
+}

src/app/configs/server.config.ts

@@ -0,0 +1,64 @@
+import {
+    env,
+    basePath,
+    ORMSession,
+    LocalFilesystem,
+    LocalFilesystemConfig,
+    BusConnectorConfig,
+    QueueConfig,
+    SyncQueue,
+    MemoryCache,
+} from '@extollo/lib'
+
+export default {
+    debug: env('DEBUG_MODE', false),
+
+    session: {
+        /* The implementation of @extollo/lib.Session that serves as the session backend. */
+        driver: ORMSession,
+    },
+
+    bus: {
+        connectors: [] as BusConnectorConfig[],
+    },
+
+    queue: {
+        driver: SyncQueue,
+    } as QueueConfig,
+
+    cache: {
+        driver: MemoryCache,
+    },
+
+    /*
+     * Here, you can define various filesystem drivers that can be used in
+     * your application to store/retrieve files.
+     *
+     * The key in the object is the 'name' of the filesystem as it will be
+     * fetched in code. For example, if you have a `fubar: { ... }` item,
+     * then you can retrieve that filesystem using the Files service like
+     * so:
+     *
+     * files.getFilesystem('fubar')  // => Filesystem { ... }
+     */
+    filesystems: {
+        default: {
+            /* If true, this will serve as the default filesystem for modules in your application. */
+            isDefault: true,
+
+            /* The implementation of @extollo/lib.Filesystem that serves as the backend. */
+            driver: LocalFilesystem,
+
+            /* The config required by the filesystem driver. */
+            config: {
+                baseDir: basePath('..', 'uploads').toLocal,
+            } as LocalFilesystemConfig,
+        },
+    },
+
+    middleware: {
+        global: {
+            pre: [],
+        },
+    },
+}

src/app/http/controllers/main/Home.controller.ts

@@ -0,0 +1,45 @@
+import {Controller, view, Session, Inject, Injectable, Locale, Validator, WebSocketBus, JSONMessageEvent, Logging, Bus, WebSocketCloseEvent} from '@extollo/lib'
+import {UserLogin} from "../../../types/UserLogin";
+
+@Injectable()
+export class Home extends Controller {
+    @Inject()
+    protected readonly session!: Session;
+
+    @Inject()
+    protected readonly locale!: Locale;
+
+    @Inject()
+    protected readonly logging!: Logging
+
+    public welcome() {
+        this.session.set('app_visits', this.session.get('app_visits', 0) + 1)
+
+        const valid = new Promise<UserLogin>(() => {})
+
+        return view('@extollo:welcome', {
+            app_visits: this.session.get('app_visits'),
+            locale: this.locale.helper(),
+        })
+    }
+
+    public async socket(ws: WebSocketBus): Promise<void> {
+        ws.subscribe(JSONMessageEvent, event => {
+            this.logging.info('Got JSON message event:')
+            this.logging.debug(event.value)
+        })
+
+        const interval = setInterval(() => {
+            ws.push(new JSONMessageEvent({ hello: 'world!' }))
+        }, 5000)
+
+        await this.request.make<Bus>(Bus)
+            .subscribe(WebSocketCloseEvent, () => {
+                clearInterval(interval)
+            })
+    }
+
+    public test() {
+        return new Validator<UserLogin>()
+    }
+}

src/app/http/middlewares/LogRequest.middleware.ts

@@ -0,0 +1,11 @@
+import {Inject, Injectable, Logging, Middleware} from '@extollo/lib'
+
+@Injectable()
+export class LogRequest extends Middleware {
+    @Inject()
+    protected readonly logging!: Logging
+
+    public async apply() {
+        this.logging.info(`Incoming request: ${this.request.method} @ ${this.request.path}`)
+    }
+}

src/app/http/routes/app.routes.ts

@@ -0,0 +1,9 @@
+import {
+    Route,
+} from '@extollo/lib'
+import {Home} from '../controllers/main/Home.controller'
+
+Route.group('/', () => {
+    Route.get('/')
+        .calls<Home>(Home, home => home.welcome)
+})

src/app/jobs/LogMessage.job.ts

@@ -0,0 +1,12 @@
+import {Injectable, BaseJob} from '@extollo/lib'
+
+@Injectable()
+export default class LogMessage extends BaseJob {
+    async execute(): Promise<void> {
+        this.logging.info('Executing LogMessage...')
+        await new Promise<void>(res => {
+            setTimeout(() => res(), 3000)
+        })
+        this.logging.success('The LogMessage job has executed!')
+    }
+}

src/app/models/User.model.ts

@@ -0,0 +1,5 @@
+import {ORMUser} from '@extollo/lib'
+
+export class User extends ORMUser {
+
+}

src/app/resources/views/welcome.pug

@@ -0,0 +1,6 @@
+html
+    head
+        title !{locale('app_name')}
+    body
+        h1 !{locale('welcome_to_extollo')}
+        h2 !{locale('viewed_page_num_times', { interp: { num: app_visits } })}

src/app/types/UserLogin.ts

@@ -0,0 +1,14 @@
+
+export interface UserLogin {
+    /**
+     * @minLength 1
+     * @maxLength 100
+     */
+    username: string,
+
+    /**
+     * @minLength 1
+     * @maxLength 100
+     */
+    password: string,
+}

src/bootstrap.ts

@@ -0,0 +1,42 @@
+import {Application, CommandLineApplication, Foreground} from '@extollo/lib'
+import {Units} from './Units.extollo'
+
+/*
+ * Helper functions to bootstrap the Application instance for different uses.
+ */
+
+/**
+ * Get the base application with no final-target unit.
+ */
+export function base(): Application {
+    const app = Application.getApplication()
+    app.scaffold(__dirname, Units.slice(0, -1))
+    return app
+}
+
+/**
+ * Get the application with the final unit replaced with the CommandLineApplication
+ * for use on the CLI.
+ */
+export function cli(): Application {
+    const app = Application.getApplication()
+    app.forceStartupMessage = false
+
+    const units = [...Units, CommandLineApplication]
+
+    app.scaffold(__dirname, units)
+    return app
+}
+
+/**
+ * Get the application as it should be run normally.
+ */
+export function app(): Application {
+    const app = Application.getApplication()
+
+    const units = [...Units]
+    units.push(Foreground)
+
+    app.scaffold(__dirname, units)
+    return app
+}

src/cli.ts

@@ -0,0 +1,15 @@
+#!/usr/bin/env -S node --experimental-repl-await
+import {globalRegistry} from '@extollo/lib'
+import {cli} from './bootstrap'
+
+globalRegistry.run(async () => {
+    /*
+     * The Application
+     * -----------------------------------------------------
+     * The application instance is a global inversion of control container that
+     * ties your entire application together. The app container manages services
+     * and lifecycle.
+     */
+    const app = cli()
+    await app.run()
+})

src/index.ts

@@ -0,0 +1,13 @@
+import {globalRegistry} from '@extollo/lib'
+import {app} from './bootstrap'
+
+globalRegistry.run(async () => {
+    /*
+     * The Application
+     * -----------------------------------------------------
+     * The application instance is a global inversion of control container that
+     * ties your entire application together. The app container manages services
+     * and lifecycle.
+     */
+    await app().run()
+})

tsconfig.json

@@ -0,0 +1,15 @@
+{
+  "compilerOptions": {
+    "target": "esnext",
+    "module": "commonjs",
+    "declaration": true,
+    "outDir": "./lib",
+    "strict": true,
+    "experimentalDecorators": true,
+    "emitDecoratorMetadata": true,
+    "skipLibCheck": true,
+    "lib": ["esnext", "dom", "dom.iterable"],
+    "preserveSymlinks": true
+  },
+  "include": ["src"]
+}