• parse files
• type checking

// .nest/module.json

{
  "$schema": "https://nest.land/-/nest-cli/schema.json",

  "name": "mod",
  "full_name": "My Awesome Module",
  "description": "I swear my module is the best out there",
  "homepage": "https://my.awesome.module",
  "license": "LICENSE",

  "hooks": {
    "presync": "command",
    "postsync": "command",
    "prepack": "command",
    "postpack": "command",
    "prepublish": "command",
    "postpublish": "command",
    "preaudit": "command",
    "postaudit": "command"
  },

  "unlisted": false,
  "private": false
  // ...
}

// .nest/module.json interface
interface Module {
  $schema: string;

  name: string;
  fullName?: string; // default: `${name}`
  description?: string; // default: ""
  homepage?: string; // default: `https://nest.land/x/${user}/${module}`
  license?: string; // default: "UNKNOWN"

  hooks: {
    presync: string; // default: ""
    postsync: string; // default: ""
    prepack: string; // default: ""
    postpack: string; // default: ""
    prepublish: string; // default: ""
    postpublish: string; // default: ""
    preaudit: string; // default: ""
    postaudit: string; // default: ""
  };

  unlisted?: boolean; // default: false
  private?: boolean; // default: false
  // ...
}

// .nest/data.json

// THIS IS AN AUTOGENERATED FILE. DO NOT EDIT THIS FILE DIRECTLY.

{
  "meta": {
    "name": "mod",
    "full_name": "My Awesome Module",
    "description": "I swear my module is the best out there",
    "homepage": "https://my.awesome.module",
    "license": "LICENSE",

    "hooks": {
      "presync": "command",
      "postsync": "command",
      "prepack": "command",
      "postpack": "command",
      "prepublish": "command",
      "postpublish": "command",
      "preaudit": "command",
      "postaudit": "command"
    },

    "unlisted": false,
    "private": false
    // ...
  },
  // cache the api for offline use
  "api": {
    "versions": ["1.0.0", "0.9.8", "0.9.7", "..."],
    "latestVersion": "1.0.0",
    "lastPublished": 1603171976111,
    "license": "MIT"
    // ...
  },
  "version": "1.0.0", // nest cli version
  "lastSync": 1602831956336,
  "nextAutoSync": 1602832005131
  // ...
}

🐛 Bug Report

The forst instruktion in the readme "INSTALL" does not work.

To Reproduce

1. Run deno install -Af https://nest.land/-/nest/nest.ts

Expected behavior

Nest.land installs successfully

Actual Behavior

Deno throws error "error: An unsupported media type was attempted to be imported as a module." because https://nest.land/-/nest/nest.ts returns 404.

Environment

• CLI version: -
• Deno version: deno 1.7.1
• Operating system and version: Windows 10 v88.0.4324.150

Additional context

-

• implement logic

nest setup <name> # link current directory to an existing module

• implement logic

nest switch [username] # switch to another user

• implement logic

nest login # prompt for login info
nest login [username] [token]

• implement UI
• find a way to determine if a module is already initialized and linked
• get username

nest init # asks to initialize a new module or link an existing one

  # if a module is already initialized and linked, just sync the metadata

  # Nest CLI 1.0.0
  # ? setup "~/mod"? [Y/n]:
  # ? link to an existing module? [Y/n]:
  # ? what's the name of your existing module? (mod):
  # i linked to "user/mod" (created .nest and added it to .gitignore)

  # Nest CLI 1.0.0
  # ? Setup "~/mod"? [Y/n]:
  # ? Link to an existing module? [Y/n]: n
  # ? Module name (mod):
  # ? Version (0.1.0):
  # ? Description:
  # ? Homepage:
  # i Linked to "user/mod" (created .nest and added it to .gitignore)

nest init <name> # initialize a new module in specified directory

• Implement logic

nest settings # opens user settings in editor

• implement global command options
• help command
• catch errors and output log to file
• flags type checking
• custom logger
• UX
  • advise on similar commands, flags, etc.
• UI
  • use ASCII for stdout as much as possible
  • consistent look and feel

• implement logic
• update to new route format
• change eggs to nest

nest upgrade [version] # upgrade nest cli to the given version

[version] A given version, the latest by default

• implement logic

# .nest/ignore

@extends .gitignore

docs/
tests/
CHANGELOG
CODE_OF_CONDUCT.md
CONTRIBUTING.md
funding.yml

# all dot files are ignored by default so user needs to include them
!.shared_dot_file
!.shared_dot_directory/

• implement logic

nest register # opens the register page in browser

• 1. compare the config in module.json (user editable) and data.json.
• 1.1 if they are same just download the remote config (same as sync)
• 1.2 if not same
• 1.2.1 check what properties have changed
• 1.2.2 download the remote config
• 1.2.3 update the new properties
• 1.2.4 upload the final result to the api

nest sync

Steps

nest publish

1. evaluate the config
2. create a tarball with a uuid in the file name
3. upload the tarball and config to twig
4. twig does it's magic and uploads to arweave
5. twig sends the arweave URLs and the config to the api
6. db gets updated, module is published

nest publish --wallet <path>

1. evaluate the config
2. create a tarball
3. upload the tarball to arweave and get the file URLs
4. send the arweave URLs and the config to the api
5. db is updated, module is published

CLI

nest publish [ version ] [ --git ] [ --pre <id> ] [ --deno <semver>] [ --wallet <path> ] [ --unlisted ]

ARGUMENTS

  version            semver tag or one of "major", "minor", "patch" (default: "patch")

OPTIONS

  --git              use the latest git tag as version (ignored if <version> is provided)
  --pre <id>         publish as a prerelease with optional identifier
  --deno <semver>    semver range for supported deno versions
  --wallet <path>    path to custom arweave wallet
  --unlisted         publish as an unlisted version

semver behavior

# say the current version is [email protected]

nest publish                      # [email protected]
nest publish 1.2.3                # [email protected]
nest publish patch                # [email protected]
nest publish minor                # [email protected]
nest publish major                # [email protected]

nest publish --pre                # [email protected]
nest publish 1.2.3 --pre          # [email protected]
nest publish patch --pre          # [email protected]
nest publish minor --pre          # [email protected]
nest publish major --pre          # [email protected]

nest publish --pre alpha          # [email protected]
nest publish 1.2.3 --pre beta     # [email protected]
nest publish patch --pre rc       # [email protected]
nest publish minor --pre asdf     # [email protected]
nest publish major --pre pre      # [email protected]

Notes

• if no versions are published yet and user runs nest publish use the version 0.1.0 (unstable)
• when (and only) uploading to twig, include the .nest directory in the tarball

ToDo

• create a tarball
• send the config and uuid to the api
• upload the tarball to arweave
• do the twig magic locally

• implement logic

nest audit # returns an audit report

Desktop 🍎 deno install -Af https://nest.land/-/nest/nest.ts

Download https://nest.land/-/nest/nest.ts
error: An unsupported media type was attempted to be imported as a module.
  Specifier: https://nest.land/-/nest/nest.ts
  MediaType: Unknown

env:

Desktop 🍎  deno --version
deno 1.8.3 (release, x86_64-apple-darwin)
v8 9.0.257.3
typescript 4.2.2

🚀 Feature

All the info that should not be view or edited by the user should be stored in localstorage.

Motivation

Deno added support for WebStorage API

blog post: https://deno.com/blog/v1.10#support-for-web-storage-api

This would also make the code a bit cleaner since we won't have to poke the environment variables to find the home directory just to get the user's access token.

pr: denoland/deno#7819

Implementation

The user would define the location during install like so:

deno install -qA --unstable --location https://nest.land https://nest.land/-/nest/nest.ts

and used like so:

// Add new user (nest login)
addUser(username: string, token: string) {
  const users: Users = JSON.parse(localStorage.getItem('users'));
	  
  users[username] = { token }

  localStorage.setItem('users', JSON.stringify(users);
}

addUser('maximousblk', 'NEST_6FF4C8F4374F46C5A5928AFE85C2354EA37AED00')


// Change active user (nest switch)
setActiveUser(username: string) {
  localStorage.setItem('activeUser', username);
}

setActiveUser('maximousblk')

Alternatives

n/a

Additional context

n/a

• Implement logic

nest settings # opens user settings in editor

• ignore file parsing
• JSON diff
• type checking
• version
• CLI performances
• etc.

• Use the latest standard modules as much as possible
  • semver on nest
• Avoid using --unstable APIs
• Store all config in a temporary .nest directory
• Exclude all dotfiles by default while publishing
• Enforce semver
• Companion server for gui (later)

• Implement logic

nest logout [username] # logout of current account