@furrymink/cli 0.0.0-stage → 0.0.2

package/README.md

@@ -1,3 +1,93 @@
-# Temporary Holding Version
+# Cli
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+
+
+## Getting started
+
+To make it easy for you to get started with GitLab, here's a list of recommended next steps.
+
+Already a pro? Just edit this README.md and make it your own. Want to make it easy? [Use the template at the bottom](#editing-this-readme)!
+
+## Add your files
+
+* [Create](https://docs.gitlab.com/user/project/repository/web_editor/#create-a-file) or [upload](https://docs.gitlab.com/user/project/repository/web_editor/#upload-a-file) files
+* [Add files using the command line](https://docs.gitlab.com/topics/git/add_files/#add-files-to-a-git-repository) or push an existing Git repository with the following command:
+
+```
+cd existing_repo
+git remote add origin https://gitlab.com/furrymink/cli.git
+git branch -M main
+git push -uf origin main
+```
+
+## Integrate with your tools
+
+* [Set up project integrations](https://gitlab.com/furrymink/cli/-/settings/integrations)
+
+## Collaborate with your team
+
+* [Invite team members and collaborators](https://docs.gitlab.com/user/project/members/)
+* [Create a new merge request](https://docs.gitlab.com/user/project/merge_requests/creating_merge_requests/)
+* [Automatically close issues from merge requests](https://docs.gitlab.com/user/project/issues/managing_issues/#closing-issues-automatically)
+* [Enable merge request approvals](https://docs.gitlab.com/user/project/merge_requests/approvals/)
+* [Set auto-merge](https://docs.gitlab.com/user/project/merge_requests/auto_merge/)
+
+## Test and Deploy
+
+Use the built-in continuous integration in GitLab.
+
+* [Get started with GitLab CI/CD](https://docs.gitlab.com/ci/quick_start/)
+* [Analyze your code for known vulnerabilities with Static Application Security Testing (SAST)](https://docs.gitlab.com/user/application_security/sast/)
+* [Deploy to Kubernetes, Amazon EC2, or Amazon ECS using Auto Deploy](https://docs.gitlab.com/topics/autodevops/requirements/)
+* [Use pull-based deployments for improved Kubernetes management](https://docs.gitlab.com/user/clusters/agent/)
+* [Set up protected environments](https://docs.gitlab.com/ci/environments/protected_environments/)
+
+***
+
+# Editing this README
+
+When you're ready to make this README your own, just edit this file and use the handy template below (or feel free to structure it however you want - this is just a starting point!). Thanks to [makeareadme.com](https://www.makeareadme.com/) for this template.
+
+## Suggestions for a good README
+
+Every project is different, so consider which of these sections apply to yours. The sections used in the template are suggestions for most open source projects. Also keep in mind that while a README can be too long and detailed, too long is better than too short. If you think your README is too long, consider utilizing another form of documentation rather than cutting out information.
+
+## Name
+Choose a self-explaining name for your project.
+
+## Description
+Let people know what your project can do specifically. Provide context and add a link to any reference visitors might be unfamiliar with. A list of Features or a Background subsection can also be added here. If there are alternatives to your project, this is a good place to list differentiating factors.
+
+## Badges
+On some READMEs, you may see small images that convey metadata, such as whether or not all the tests are passing for the project. You can use Shields to add some to your README. Many services also have instructions for adding a badge.
+
+## Visuals
+Depending on what you are making, it can be a good idea to include screenshots or even a video (you'll frequently see GIFs rather than actual videos). Tools like ttygif can help, but check out Asciinema for a more sophisticated method.
+
+## Installation
+Within a particular ecosystem, there may be a common way of installing things, such as using Yarn, NuGet, or Homebrew. However, consider the possibility that whoever is reading your README is a novice and would like more guidance. Listing specific steps helps remove ambiguity and gets people to using your project as quickly as possible. If it only runs in a specific context like a particular programming language version or operating system or has dependencies that have to be installed manually, also add a Requirements subsection.
+
+## Usage
+Use examples liberally, and show the expected output if you can. It's helpful to have inline the smallest example of usage that you can demonstrate, while providing links to more sophisticated examples if they are too long to reasonably include in the README.
+
+## Support
+Tell people where they can go to for help. It can be any combination of an issue tracker, a chat room, an email address, etc.
+
+## Roadmap
+If you have ideas for releases in the future, it is a good idea to list them in the README.
+
+## Contributing
+State if you are open to contributions and what your requirements are for accepting them.
+
+For people who want to make changes to your project, it's helpful to have some documentation on how to get started. Perhaps there is a script that they should run or some environment variables that they need to set. Make these steps explicit. These instructions could also be useful to your future self.
+
+You can also document commands to lint the code or run tests. These steps help to ensure high code quality and reduce the likelihood that the changes inadvertently break something. Having instructions for running tests is especially helpful if it requires external setup, such as starting a Selenium server for testing in a browser.
+
+## Authors and acknowledgment
+Show your appreciation to those who have contributed to the project.
+
+## License
+For open source projects, say how it is licensed.
+
+## Project status
+If you have run out of energy or time for your project, put a note at the top of the README saying that development has slowed down or stopped completely. Someone may choose to fork your project or volunteer to step in as a maintainer or owner, allowing your project to keep going. You can also make an explicit request for maintainers.

package/bin/app/create/gateway.sh

@@ -0,0 +1,31 @@
+app.gateway(){
+    echo "app.create"
+    local ARGS=("$@")
+
+    local _DEVICE=$(
+        input.select "Select device" \
+            --prefill "1" \
+            --options "Mobile|Desktop|Web|Watch|TV"
+    )
+
+    case $_DEVICE in
+        "Mobile")
+            app.create.mobile "${ARGS[@]}"
+        ;;
+        "Desktop")
+            console.log "Not yet implemented"
+        ;;
+        "Web")
+            console.log "Not yet implemented"
+        ;;
+        "Watch")
+            console.log "Not yet implemented"
+        ;;
+        "TV")
+            console.log "Not yet implemented"
+        ;;
+        *)
+            console.error "Invalid choice"
+        ;;
+    esac
+}

package/bin/app/create/includes.sh

@@ -0,0 +1,6 @@
+include.scripts "app/create/mobile.sh"
+include.scripts "app/create/mobile.wrapped.sh"
+include.scripts "app/create/mobile.native.sh"
+include.scripts "app/create/mobile.native.apple.sh"
+include.scripts "app/create/mobile.native.android.sh"
+include.scripts "app/create/gateway.sh"

package/bin/app/create/mobile.native.android.sh

@@ -0,0 +1,3 @@
+app.create.mobile.native.android(){
+    echo "Create native android app"
+}

package/bin/app/create/mobile.native.apple.sh

@@ -0,0 +1,3 @@
+app.create.mobile.native.apple(){
+    echo "Create native apple app"
+}

package/bin/app/create/mobile.native.sh

@@ -0,0 +1,24 @@
+app.create.mobile.native(){
+    console.header "Create Native Mobile App"
+
+    local ARGS=("$@")
+
+    local _DEVICE=$(
+        input.select "OS" \
+            --prefill "1" \
+            --options "Apple|Android"
+    )
+
+    case $_DEVICE in
+        "Apple")
+            app.create.mobile.native.apple "${ARGS[@]}"
+        ;;
+        "Android")
+            app.create.mobile.wrapped.android "${ARGS[@]}"
+        ;;
+        *)
+            console.error "Invalid choice"
+        ;;
+    esac
+
+}

package/bin/app/create/mobile.sh

@@ -0,0 +1,24 @@
+app.create.mobile(){
+    console.header "Create Mobile App"
+
+    local ARGS=("$@")
+
+    local _DEVICE=$(
+        input.select "Type" \
+            --prefill "1" \
+            --options "Native|Native(Wrapped)"
+    )
+
+    case $_DEVICE in
+        "Native")
+            app.create.mobile.native "${ARGS[@]}"
+        ;;
+        "Native(Wrapped)")
+            app.create.mobile.wrapped "${ARGS[@]}"
+        ;;
+        *)
+            console.error "Invalid choice"
+        ;;
+    esac
+
+}

package/bin/app/create/mobile.wrapped.sh

@@ -0,0 +1,58 @@
+__furrymink.install.ios(){
+    npm install @capacitor/ios
+    npx cap add ios
+}
+__furrymink.install.android(){
+    npm install @capacitor/android
+    npx cap add android
+}
+
+furrymink.create.mobile.wrapped(){
+    console.header "Create Wrapped Mobile App"
+
+    local ARGS=("$@")
+    local _BASE_REPO_URL="furrymink"
+
+    local _APP_NAME=$(get.app-name "my-app")
+    local _NORMALISED_APP_NAME=$(normalise.package-id $_APP_NAME)
+    local _GIT_BASE_URL="${_BASE_REPO_URL}/${_NORMALISED_APP_NAME}"
+
+    local _PACKAGE_ID=$(get.package-id $_BASE_REPO_URL $_APP_NAME)
+    local _HOMEPAGE_URL=$(get.home-page-url "$_GIT_BASE_URL")
+    local _REPO_URL=$(get.repo-url "$_GIT_BASE_URL")
+    local _README_URL=$(get.read-me-url "$_GIT_BASE_URL")
+    local _BUGS_URL=$(get.bugs-url "$_GIT_BASE_URL")
+    local _LICENSE_URL=$(get.license "$_GIT_BASE_URL")
+    local _AUTHOR_URL=$(get.author "$_GIT_BASE_URL")
+    local _DESCRIPTION=$(get.description "Give a short description of what $_APP_NAME does")
+    local _DEV_BOWSER_PORT=$(get.broswer-port "3000")
+    local _TYPE=$(get.type)
+
+    local _PLATFORM=""
+
+    npx cap init "${_APP_NAME}" "${PACKAGE_ID}" --web-dir "www/dist"
+
+    local _TARGET_PLATFORM=$(
+        input.select "Select OS" \
+            --prefill "1" \
+            --options "Android|iOS|Both"
+    )
+
+    case $_TARGET_PLATFORM in
+        "Android")
+            __furrymink.install.android
+        ;;
+        "iOS")
+            __furrymink.install.ios
+        ;;
+        "Both")
+            __furrymink.install.android
+            __furrymink.install.ios
+        ;;
+        *)
+            console.error "Invalid choice" >&2
+            install-capacitor
+        ;;
+    esac
+
+}

package/bin/app/gateway.sh

@@ -0,0 +1,14 @@
+app.gateway(){
+    console.header "app.gateway"
+    local COMMAND="$1"
+    shift
+
+    local ARGS=("$@")
+
+    case $COMMAND in
+        "create" | "c" )
+            app.create "${ARGS[@]}";;
+        *)
+            console.error "Invalid create command";;
+    esac
+}

package/bin/app/includes.sh

@@ -0,0 +1 @@
+include.scripts "app/create/includes.sh"

package/bin/cli/entry-point.sh

@@ -0,0 +1,5 @@
+
+
+cli.entry-point(){
+    cli.gateway "$@"
+}

package/bin/cli/gateway.sh

@@ -0,0 +1,24 @@
+cli.gateway(){
+    local COMMAND="$1"
+    shift
+
+    local ARGS=("$@")
+
+    case $COMMAND in
+        git)
+            console.echo "GIT"
+            git.gateway "${ARGS[@]}";;
+            # include.scripts "git/entry.sh" "$@";;
+        npm)
+            console.echo "NPM"
+            npm.gateway "${ARGS[@]}";;
+            # include.scripts "npm/entry.sh" "$@";;
+        create)
+            create.gateway "${ARGS[@]}";;
+            # include.scripts "plugin/entry.sh" "$@";;
+        *)
+            console.error "Unknown command '${COMMAND}'";;
+
+    esac
+
+}

package/bin/cli/includes.sh

@@ -0,0 +1,9 @@
+include.scripts \
+    "modules/includes.sh" \
+    "git/includes.sh" \
+    "npm/includes.sh" \
+    "create/includes.sh" \
+    "app/includes.sh" \
+    "plugin/includes.sh" \
+    "cli/gateway.sh" \
+    "cli/entry-point.sh"

package/bin/create/gateway.sh

@@ -0,0 +1,17 @@
+create.gateway(){
+    local _TYPE="$1"
+    shift
+
+    local ARGS=("$@")
+
+    case $_TYPE in
+        "app")
+            ARGS=("create" "${ARGS[@]}")
+            app.gateway "${ARGS[@]}";;
+        "plugin")
+            ARGS=("create" "${ARGS[@]}")
+            furrymink.plugin.gateway "${ARGS[@]}";;
+        *)
+            console.error "Invalid create command";;
+    esac
+}

package/bin/create/includes.sh

@@ -0,0 +1 @@
+include.scripts "create/gateway.sh"

package/bin/furrymink

@@ -0,0 +1,17 @@
+#! /bin/bash
+BIN_PATH="$(cd -- "$(dirname -- "$(realpath -- "${BASH_SOURCE[0]}")")" && pwd)"
+CLI_PATH="$(realpath "$BIN_PATH/..")"
+MODULES_PATH="${BIN_PATH}/modules"
+
+include.scripts(){
+    local SCRIPTS=("$@")
+    local PATH=""
+
+    for SCRIPT in "${SCRIPTS[@]}"; do
+        . "${BIN_PATH}/${SCRIPT}"
+    done
+}
+
+include.scripts "cli/includes.sh"
+
+cli.entry-point "$@"

package/bin/git/commit.sh

@@ -0,0 +1,18 @@
+furrymink.git.commit(){
+    console.header "furrymink.git.commit"
+
+    local _MESSAGE="New commit"
+
+    while [[ $# -gt 0 ]]; do
+        case $1 in
+            --message | -m )
+                _MESSAGE="$2"
+                shift 2;;
+            *)
+                console.error "Invalid commit command"; exit 1;;
+        esac
+    done
+
+    git add .
+    git commit -m "${_MESSAGE}"
+}

package/bin/git/gateway.sh

@@ -0,0 +1,19 @@
+furrymink.git.gateway(){
+    console.header "furrymink.git.gateway"
+    local COMMAND="$1"
+    shift
+
+    local ARGS=("$@")
+
+    case $COMMAND in
+        "commit" | "c" )
+            console.echo "GIT COMMIT"
+            furrymink.git.commit "${ARGS[@]}";;
+            #git.commit $@;;
+        "push")
+            console.echo "GIT PUSH";;
+            #git.push $@;;
+        *)
+            console.error "Invalid git command";;
+    esac
+}

package/bin/git/includes.sh

@@ -0,0 +1,4 @@
+include.scripts \
+    "git/gateway.sh" \
+    "git/commit.sh" \
+    "git/push.sh"

package/bin/git/push.sh

@@ -0,0 +1,5 @@
+furrymink.git.push(){
+    console.header "furrymink.git.push"
+
+    git push
+}

package/bin/git/rebase.sh

@@ -0,0 +1,18 @@
+furrymink.git.rebase(){
+    console.header "furrymink.git.rebase"
+
+    local _BRANCH="main"
+
+    while [[ $# -gt 0 ]]; do
+        case $1 in
+            --branch | -b )
+                _BRANCH="$2"
+                shift 2;;
+            *)
+                console.error "Invalid rebase command"; exit 1;;
+        esac
+    done
+
+    git rebase -i --autostash "${_BRANCH}"
+
+}

package/bin/modules/console/console.echo.sh

@@ -0,0 +1,95 @@
+#!/bin/bash
+
+console.echo(){
+    local MESSAGE="$1"
+    shift
+
+    local RED=""
+    local GREEN=""
+    local BLUE=""
+    local FORE=$'\e[38;2;255;0;0m\e[48;2;100;0;0m'
+    local BACK=""
+    local PREFIX=""
+    local SUFFIX=$'\n'
+    local PADDING=""
+    local PADS=()
+    local RESET=$'\033[0m'
+    local STREAM="false"
+    
+    while [[ $# -gt 0 ]]; do
+        case $1 in
+            --padding)
+                PADDING=$2
+                IFS=' ' read -r -a PADS <<< "$PADDING"
+
+                # Iterate over the resulting list
+                for PAD in "${PADS[@]}"; do
+                    case $PAD in
+                        "top")
+                            PREFIX="$PREFIX"$'\n'
+                        ;;
+                        "bottom")
+                            SUFFIX="$SUFFIX"$'\n'
+                        ;;
+                        "left")
+                            PREFIX="$PREFIX"$'\t'
+                        ;;
+                        "right")
+                            SUFFIX="$SUFFIX"$'\t'
+                        ;;
+                        *) 
+                            echo "ERROR"
+                        ;;
+                    esac
+
+                done
+                shift 2 ;;
+
+            --foreground)
+                RED="$2";
+                GREEN="$3";
+                BLUE="$4";
+
+                FORE=$'\e[38;2;'$RED';'$GREEN';'$BLUE'm'
+                shift 4 ;;
+
+            --background)
+                RED="$2";
+                GREEN="$3";
+                BLUE="$4";
+
+                BACK=$'\e[48;2;'$RED';'$GREEN';'$BLUE'm'
+                shift 4 ;;
+            --no-wrap)
+                SUFFIX=""
+                shift 1 ;;
+            --to-stream)
+                STREAM="true"
+                shift 1 ;;
+            --bold)
+                PREFIX="$PREFIX"$'\e[1m'
+                shift 1 ;;
+            --italic)
+                PREFIX="$PREFIX"$'\e[3m'
+                shift 1 ;;
+            *)  exit 1;;
+        esac
+    done
+
+    if [[ $STREAM == "true" ]]; then
+        printf '%s%s%s%s%s' \
+            "$PREFIX" \
+            "$FORE$BACK" \
+            "$MESSAGE" \
+            "$RESET" \
+            "$SUFFIX" >&2
+    else
+        printf '%s%s%s%s%s' \
+            "$PREFIX" \
+            "$FORE$BACK" \
+            "$MESSAGE" \
+            "$RESET" \
+            "$SUFFIX" 
+    fi
+    
+}

package/bin/modules/console/console.error.sh

@@ -0,0 +1,14 @@
+console.error(){
+    local MESSAGE="$1"
+    local PREFIX="Error: "
+    local SUFFIX=" !!"
+    
+    local COMPOSED_MESSAGE="${PREFIX}${MESSAGE}${SUFFIX}"
+    local FOREGROUND="255 0 255"
+    local BACKGROUND="200 0 0";
+    
+    console.echo "$COMPOSED_MESSAGE" \
+        --padding "top bottom" \
+        --foreground $FOREGROUND \
+        --background $BACKGROUND
+}

package/bin/modules/console/console.header.sh

@@ -0,0 +1,10 @@
+console.header(){
+    local MESSAGE="$1"
+    
+    local FOREGROUND="255 255 0"
+    local BACKGROUND="0 0 255";
+    
+    console.echo "$MESSAGE" \
+        --padding "top" \
+        --foreground $FOREGROUND 
+}

package/bin/modules/console/console.hint.sh

@@ -0,0 +1,20 @@
+console.hint(){
+    local MESSAGE="$1"
+    shift
+    
+    local FOREGROUND="255 255 255"
+    local BACKGROUND="25 25 255";
+    local DELIMETER=""
+
+    while [[ $# -gt 0 ]]; do
+        case $1 in
+            --delimeter) DELIMETER="$2 "; shift 2 ;;
+            *) echo "Unknown: $1" >&2; return 1 ;;
+        esac
+    done
+    
+    console.echo "$DELIMETER$MESSAGE" \
+        --foreground $FOREGROUND \
+        --background $BACKGROUND \
+        --to-stream
+}

package/bin/modules/console/console.info.sh

@@ -0,0 +1,10 @@
+console.info(){
+    local MESSAGE="$1"
+    
+    local FOREGROUND="255 255 255"
+    local BACKGROUND="25 25 255";
+    
+    console.echo "$MESSAGE" \
+        --foreground $FOREGROUND \
+        --background $BACKGROUND 
+}

package/bin/modules/console/console.keypair.sh

@@ -0,0 +1,19 @@
+console.keypair(){
+    local KEY="$1"
+    local VALUE="$2"
+    
+    local FOREGROUND_KEY="0 255 255"
+    local FOREGROUND_VALUE="255 255 0"
+    local FOREGROUND_EQUALS="0 0 255"
+    
+    console.echo "$KEY" \
+        --foreground $FOREGROUND_KEY \
+        --no-wrap
+
+    console.echo " = " \
+        --foreground $FOREGROUND_EQUALS \
+        --no-wrap
+
+    console.echo "$VALUE" \
+        --foreground $FOREGROUND_VALUE
+}

package/bin/modules/console/console.log.sh

@@ -0,0 +1,8 @@
+console.log(){
+    local MESSAGE="$1"
+
+    local FOREGROUND="100 100 100"
+    
+    console.echo "$MESSAGE" \
+        --foreground $FOREGROUND 
+}

package/bin/modules/console/console.prompt.sh

@@ -0,0 +1,40 @@
+console.prompt(){
+    local PROMPT="$1"
+    shift
+
+    local DELIMETER=">"
+    local FOREGROUND="255 0 0"
+    local WARNING_FOREGROUND="255 255 255"
+    local WARNING_BACKGROUND="255 0 0"
+    local WARNING_MESSAGE=""
+
+    while [[ $# -gt 0 ]]; do
+        case $1 in
+            --delimiter) DELIMETER="$2"; shift 2 ;;
+            --prefill)  PREFILL="$2";  shift 2 ;;
+            --warn)  WARNING_MESSAGE="$2";  shift 2 ;;
+            *) echo "Unknown: $1" >&2; return 1 ;;
+        esac
+    done
+    
+    local COMPOSED_PROMPT="${PROMPT}${DELIMETER}"
+
+    if [[ $WARNING_MESSAGE == "" ]]; then
+        console.echo "$COMPOSED_PROMPT" \
+            --foreground $FOREGROUND \
+            --no-wrap \
+            --bold \
+            --to-stream
+    else
+        console.echo "$COMPOSED_PROMPT" \
+            --foreground $FOREGROUND \
+            --to-stream
+
+        console.echo "$WARNING_MESSAGE" \
+            --foreground $WARNING_FOREGROUND \
+            --background $WARNING_BACKGROUND \
+            --no-wrap \
+            --bold \
+            --to-stream
+    fi
+}

package/bin/modules/console/console.warn.sh

@@ -0,0 +1,33 @@
+console.warn(){
+    local MESSAGE="$1"
+    shift
+
+    local FOREGROUND="0 0 255"
+    local BACKGROUND="200 200 0";
+
+    local INLINE="false"
+
+    while [[ $# -gt 0 ]]; do
+        case $1 in
+            --inline)  INLINE="true";  shift 2 ;;
+            *) echo "Unknown: $1" >&2; return 1 ;;
+        esac
+    done
+
+    if [[ $INLINE == "true" ]]; then
+        console.echo "$MESSAGE" \
+            --foreground $FOREGROUND \
+            --background $BACKGROUND \
+            --bold \
+            --italic \
+            --to-stream
+    else
+        console.echo "$MESSAGE" \
+            --foreground $FOREGROUND \
+            --background $BACKGROUND \
+            --bold \
+            --italic 
+    fi
+    
+    
+}

package/bin/modules/console/includes.sh

@@ -0,0 +1,10 @@
+include.scripts \
+    "modules/console/console.error.sh" \
+    "modules/console/console.header.sh" \
+    "modules/console/console.info.sh" \
+    "modules/console/console.keypair.sh" \
+    "modules/console/console.prompt.sh" \
+    "modules/console/console.warn.sh" \
+    "modules/console/console.echo.sh" \
+    "modules/console/console.hint.sh" \
+    "modules/console/console.log.sh"

package/bin/modules/includes.sh

@@ -0,0 +1,3 @@
+include.scripts \
+    "modules/input/includes.sh" \
+    "modules/console/includes.sh"

package/bin/modules/input/includes.sh

@@ -0,0 +1,3 @@
+include.scripts \
+    "modules/input/input.text.sh" \
+    "modules/input/input.select.sh"

package/bin/modules/input/input.select.sh

@@ -0,0 +1,82 @@
+#! /bin/bash
+
+input.select(){
+    local PROMPT="$1"
+    shift
+
+    local ORIGINAL_PROMPT="$PROMPT"
+    local DELIMETER=":"
+    local PREFILL=""
+    local ANSWER=""
+    local REQUIRED="false"
+    local HINTS=""
+    local WARNING_MESSAGE=""
+    local OPTIONS_STRING=""
+    local OPTIONS=""
+    local SELECTED_LABEL=""
+    local SELECTED_INDEX=""
+
+
+    while [[ $# -gt 0 ]]; do
+        case $1 in
+            --warn) WARNING_MESSAGE="$2"; shift 2 ;;
+            --delimeter) DELIMETER="$2"; shift 2 ;;
+            --prefill)  PREFILL="$2";  shift 2 ;;
+            --required)
+                REQUIRED="true";
+                PROMPT="${PROMPT} (required)"
+                shift 1 ;;
+            --hints)  HINTS="$2";  shift 2 ;;
+            --options)  OPTIONS_STRING="$2";  shift 2 ;;
+            *) echo "Unknown: $1" >&2; return 1 ;;
+        esac
+    done
+
+    if [[ $OPTIONS_STRING == "" ]]; then
+        exit 1
+    fi
+
+    IFS='|' read -r -a OPTIONS <<< "$OPTIONS_STRING"
+
+    console.prompt "$PROMPT" --delimiter "$DELIMETER"  --warn "$WARNING_MESSAGE"
+
+    echo "" >&2
+
+    IFS='|' read -r -a HINTS_ARR <<< "$HINTS"
+
+    for HINT in "${HINTS_ARR[@]}"; do
+        console.hint "$HINT" --delimeter " -"
+    done
+
+    PS3="> "
+
+    select OPTION in "${OPTIONS[@]}"; do
+        SELECTED_LABEL=""
+        SELECTED_INDEX=""
+        
+        for OPT in "${OPTIONS[@]}"; do
+            if [[ "$OPTION" == "$OPT" ]]; then
+                SELECTED_LABEL="${OPTION}"
+                SELECTED_INDEX="${REPLY}"
+            fi
+        done
+
+        if [[ $SELECTED_INDEX != "" ]]; then 
+            break
+        else
+            if [[ $REQUIRED == "true" ]]; then
+                input.select "$ORIGINAL_PROMPT" \
+                    --prefill "1" \
+                    --options "Male|Female|Other" \
+                    --required \
+                    --hints "hint one|gont two|and a third" \
+                    --warn "This is a required field"
+            fi
+        fi
+
+    done
+
+    echo "${SELECTED_LABEL}"
+}
+
+

package/bin/modules/input/input.text.sh

@@ -0,0 +1,61 @@
+input.text(){
+    local PROMPT="$1"
+    shift
+
+    local ORIGINAL_PROMPT="$PROMPT"
+    local DELIMETER_A=">"
+    local DELIMETER_B=""
+    local PREFILL=""
+    local ANSWER=""
+    local REQUIRED="false"
+    local HINTS=""
+    local WARNING_MESSAGE=""
+
+    while [[ $# -gt 0 ]]; do
+        case $1 in
+            --warn) WARNING_MESSAGE="$2"; shift 2 ;;
+            --delimeter) DELIMETER_A="$2"; shift 2 ;;
+            --prefill)  PREFILL="$2";  shift 2 ;;
+            --required)
+                REQUIRED="true";
+                PROMPT="${PROMPT} (required)"
+                shift 1 ;;
+            --hints)  HINTS="$2";  shift 2 ;;
+            *) echo "Unknown: $1" >&2; return 1 ;;
+        esac
+    done
+
+    if [[ $HINTS != "" ]]; then
+        DELIMETER_A=":"
+        DELIMETER_B=">"
+    fi
+
+    if [[ $WARNING_MESSAGE == "" ]]; then
+        console.prompt "$PROMPT" --delimiter "$DELIMETER_A"
+    else
+        console.prompt "$PROMPT" --delimiter "$DELIMETER_A"  --warn "$WARNING_MESSAGE"
+    fi
+
+    if [[ $HINTS != "" ]]; then
+        echo "" >&2
+        IFS='|' read -r -a HINTS_ARR <<< "$HINTS"
+
+        for HINT in "${HINTS_ARR[@]}"; do
+            console.hint "$HINT" --delimeter " -"
+        done
+    fi
+
+    read -e -p "$DELIMETER_B " -i "$PREFILL" ANSWER
+
+    if [[ $REQUIRED == "true" && $ANSWER == "" ]]; then
+        input.text \
+            "${ORIGINAL_PROMPT}" \
+                --hints "${HINTS}" \
+                --prefill "${PREFILL}"\
+                --delimeter "${DELIMETER_A}"\
+                --required \
+                --warn "Required field"
+    fi
+
+    echo $ANSWER
+}

package/bin/npm/bump.sh

@@ -0,0 +1,56 @@
+furrymink.npm.bump(){
+    local _NEW_VERSION="interactive"
+    local _CURRENT_VERSION=""
+    local _VERSIONING=()
+    local _MAJOR=0
+    local _MINOR=0
+    local _PATCH=0
+
+    while [[ $# -gt 0 ]]; do
+        case $1 in
+            --version)  _NEW_VERSION="$2";  shift 2 ;;
+            *)
+                console.error "Invalid argument [Code: $1]"
+                return 1 ;;
+        esac
+    done
+
+
+    if [[ $_NEW_VERSION == "interactive" ]]; then
+        _CURRENT_VERSION=$(npm pkg get version --workspaces=false | tr -d '"')
+
+        IFS='.' read -r -a _VERSIONING <<< "$_CURRENT_VERSION"
+
+        _MAJOR=${_VERSIONING[0]}
+        _MINOR=${_VERSIONING[1]}
+        _PATCH=${_VERSIONING[2]}
+
+        BUMP=$(
+            input.select "Bump level" \
+                --prefill "1" \
+                --options "Major|Minor|Patch")
+
+        echo "BUMP: ${BUMP}"
+
+        case $BUMP in
+            "Patch")
+                _PATCH=$((_PATCH + 1))
+            ;;
+            "Minor")
+                _MINOR=$((_MINOR + 1))
+            ;;
+            "Major")
+                _MAJOR=$((_MAJOR + 1))
+            ;;
+            *)
+                console.error "Cannot bump"
+            ;;
+        esac
+
+        _NEW_VERSION="${_MAJOR}.${_MINOR}.${_PATCH}"
+
+    fi
+
+    npm version ${_NEW_VERSION}
+
+}

package/bin/npm/gateway.sh

@@ -0,0 +1,22 @@
+furrymink.npm.gateway(){
+    console.header "furrymink.git.gateway"
+    local COMMAND="$1"
+    shift
+
+    local ARGS=("$@")
+
+    case $COMMAND in
+        "login" )
+            furrymink.npm.login "${ARGS[@]}";;
+        "logout" )
+            furrymink.npm.logout "${ARGS[@]}";;
+        "publish" )
+            furrymink.npm.publish "${ARGS[@]}";;
+        "bump" )
+            furrymink.npm.bump "${ARGS[@]}";;
+        "push")
+            furrymink.npm.push "${ARGS[@]}";;
+        *)
+            console.error "Invalid git command";;
+    esac
+}

package/bin/npm/includes.sh

@@ -0,0 +1,5 @@
+include.scripts \
+    "npm/gateway.sh" \
+    "npm/login.sh" \
+    "npm/bump.sh" \
+    "npm/publish.sh"

package/bin/npm/login.sh

@@ -0,0 +1,5 @@
+furrymink.npm.login(){
+    npm login
+
+    exit 0
+}

package/bin/npm/logout.sh

@@ -0,0 +1,5 @@
+furrymink.npm.logout(){
+    npm logout
+
+    exit 0
+}

package/bin/npm/publish.sh

@@ -0,0 +1,3 @@
+furrymink.npm.publish(){
+    npm publish --access public
+}

package/bin/plugin/create.sh

@@ -0,0 +1,3 @@
+furrymink.plugin.create(){
+    echo "furrymink.plugin.create"
+}

package/bin/plugin/gateway.sh

@@ -0,0 +1,14 @@
+furrymink.plugin.gateway(){
+    console.header "furrymink.plugin.gateway"
+    local COMMAND="$1"
+    shift
+
+    local ARGS=("$@")
+
+    case $COMMAND in
+        "create" | "c" )
+            furrymink.plugin.create "${ARGS[@]}";;
+        *)
+            console.error "Invalid git command";;
+    esac
+}

package/bin/plugin/includes.sh

@@ -0,0 +1,3 @@
+include.scripts \
+    "plugin/create.sh" \
+    "plugin/gateway.sh"

package/package.json

@@ -1,6 +1,24 @@
 {
   "name": "@furrymink/cli",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
-}
+  "version": "0.0.2",
+  "description": "To make it easy for you to get started with GitLab, here's a list of recommended next steps.",
+  "main": "index.js",
+  "scripts": {
+    "test": "echo \"Error: no test specified\" && exit 1"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+ssh://git@gitlab.com/furrymink/cli.git"
+  },
+  "keywords": [],
+  "author": "",
+  "license": "",
+  "type": "commonjs",
+  "bin": {
+    "furrymink": "bin/furrymink"
+  },
+  "bugs": {
+    "url": "https://gitlab.com/furrymink/cli/issues"
+  },
+  "homepage": "https://gitlab.com/furrymink/cli#readme"
+}