shipthis 0.0.9 → 0.0.21

package/oclif.manifest.json

@@ -109,7 +109,7 @@
         },
         "appleEmail": {
           "char": "e",
-          "description": "Your Apple email address",
+          "description": "Your Apple Developer email address",
           "name": "appleEmail",
           "hasDynamicHelp": false,
           "multiple": false,
@@ -135,7 +135,7 @@
     "apple:status": {
       "aliases": [],
       "args": {},
-      "description": "Shows the status of the Apple authentication and integration",
+      "description": "Shows the status of the Apple authentication and integration.",
       "examples": [
         "<%= config.bin %> <%= command.id %>"
       ],
@@ -147,6 +147,7 @@
       "pluginName": "shipthis",
       "pluginType": "core",
       "strict": true,
+      "enableJsonFlag": false,
       "isESM": true,
       "relativePath": [
         "dist",
@@ -158,7 +159,7 @@
     "game:create": {
       "aliases": [],
       "args": {},
-      "description": "Create a new game",
+      "description": "Create a new game in ShipThis.",
       "examples": [
         "<%= config.bin %> <%= command.id %>"
       ],
@@ -204,7 +205,7 @@
     "game:details": {
       "aliases": [],
       "args": {},
-      "description": "Shows and sets the details of a game. If --gameId is not provided it will look in the current directory.",
+      "description": "Shows and sets the details of a game.",
       "examples": [
         "<%= config.bin %> <%= command.id %>",
         "<%= config.bin %> <%= command.id %> --gameId 0c179fc4",
@@ -333,7 +334,7 @@
     "game:list": {
       "aliases": [],
       "args": {},
-      "description": "Shows a list of all your games",
+      "description": "Shows a list of all your games.",
       "examples": [
         "<%= config.bin %> <%= command.id %>"
       ],
@@ -403,7 +404,7 @@
     "game:ship": {
       "aliases": [],
       "args": {},
-      "description": "Builds the app (for all platforms with valid credentials) and ships it to the stores",
+      "description": "Builds the app (for all platforms with valid credentials) and ships it to the stores.",
       "examples": [
         "<%= config.bin %> <%= command.id %>"
       ],
@@ -436,7 +437,7 @@
     "game:status": {
       "aliases": [],
       "args": {},
-      "description": "Shows the Game status. If --gameId is not provided it will look in the current directory.",
+      "description": "Shows the status of the current game.",
       "examples": [
         "<%= config.bin %> <%= command.id %>",
         "<%= config.bin %> <%= command.id %> --gameId 0c179fc4"
@@ -477,7 +478,7 @@
       "flags": {
         "forceStep": {
           "char": "f",
-          "description": "Force a specific step to run. You can repeat this flag to force multiple steps.",
+          "description": "Force a specific step to run.",
           "name": "forceStep",
           "hasDynamicHelp": false,
           "multiple": false,
@@ -487,7 +488,8 @@
           "char": "p",
           "description": "The platform to run the wizard for",
           "name": "platform",
-          "required": true,
+          "required": false,
+          "default": "ios",
           "hasDynamicHelp": false,
           "multiple": false,
           "options": [
@@ -512,10 +514,159 @@
         "wizard.js"
       ]
     },
+    "apple:apiKey:create": {
+      "aliases": [],
+      "args": {},
+      "description": "Creates an App Store Connect API Key in your Apple Developer account.\nSaves the private key in your ShipThis account.",
+      "examples": [
+        "<%= config.bin %> <%= command.id %>",
+        "<%= config.bin %> <%= command.id %> --force"
+      ],
+      "flags": {
+        "force": {
+          "char": "f",
+          "name": "force",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "quiet": {
+          "char": "q",
+          "description": "Avoid output except for interactions and errors",
+          "name": "quiet",
+          "allowNo": false,
+          "type": "boolean"
+        }
+      },
+      "hasDynamicHelp": false,
+      "hiddenAliases": [],
+      "id": "apple:apiKey:create",
+      "pluginAlias": "shipthis",
+      "pluginName": "shipthis",
+      "pluginType": "core",
+      "strict": true,
+      "isESM": true,
+      "relativePath": [
+        "dist",
+        "commands",
+        "apple",
+        "apiKey",
+        "create.js"
+      ]
+    },
+    "apple:apiKey:export": {
+      "aliases": [],
+      "args": {
+        "file": {
+          "description": "Name of the ZIP file to create",
+          "name": "file",
+          "required": true
+        }
+      },
+      "description": "Saves the current App Store Connect API Key to a ZIP file",
+      "examples": [
+        "<%= config.bin %> <%= command.id %> userApiKey.zip"
+      ],
+      "flags": {
+        "force": {
+          "char": "f",
+          "description": "Overwrite the file if it already exists",
+          "name": "force",
+          "allowNo": false,
+          "type": "boolean"
+        }
+      },
+      "hasDynamicHelp": false,
+      "hiddenAliases": [],
+      "id": "apple:apiKey:export",
+      "pluginAlias": "shipthis",
+      "pluginName": "shipthis",
+      "pluginType": "core",
+      "strict": true,
+      "enableJsonFlag": false,
+      "isESM": true,
+      "relativePath": [
+        "dist",
+        "commands",
+        "apple",
+        "apiKey",
+        "export.js"
+      ]
+    },
+    "apple:apiKey:import": {
+      "aliases": [],
+      "args": {
+        "file": {
+          "description": "Name of the ZIP file to import (must be in the same format as the export)",
+          "name": "file",
+          "required": true
+        }
+      },
+      "description": "Imports an App Store Connect API Key ZIP file into your ShipThis account",
+      "examples": [
+        "<%= config.bin %> <%= command.id %> userApiKey.zip"
+      ],
+      "flags": {
+        "force": {
+          "char": "f",
+          "name": "force",
+          "allowNo": false,
+          "type": "boolean"
+        }
+      },
+      "hasDynamicHelp": false,
+      "hiddenAliases": [],
+      "id": "apple:apiKey:import",
+      "pluginAlias": "shipthis",
+      "pluginName": "shipthis",
+      "pluginType": "core",
+      "strict": true,
+      "enableJsonFlag": false,
+      "isESM": true,
+      "relativePath": [
+        "dist",
+        "commands",
+        "apple",
+        "apiKey",
+        "import.js"
+      ]
+    },
+    "apple:apiKey:status": {
+      "aliases": [],
+      "args": {},
+      "description": "Displays the status of App Store Connect API Keys in your Apple and ShipThis accounts.\nThis API key is used to automatically publish your games to the App Store.",
+      "examples": [
+        "<%= config.bin %> <%= command.id %>",
+        "<%= config.bin %> <%= command.id %> --noAppleAuth"
+      ],
+      "flags": {
+        "noAppleAuth": {
+          "char": "f",
+          "name": "noAppleAuth",
+          "allowNo": false,
+          "type": "boolean"
+        }
+      },
+      "hasDynamicHelp": false,
+      "hiddenAliases": [],
+      "id": "apple:apiKey:status",
+      "pluginAlias": "shipthis",
+      "pluginName": "shipthis",
+      "pluginType": "core",
+      "strict": true,
+      "enableJsonFlag": false,
+      "isESM": true,
+      "relativePath": [
+        "dist",
+        "commands",
+        "apple",
+        "apiKey",
+        "status.js"
+      ]
+    },
     "apple:certificate:create": {
       "aliases": [],
       "args": {},
-      "description": "Creates an iOS Distribution Certificate in your Apple Developer account and saves it with the private key to your ShipThis account",
+      "description": "Creates an iOS Distribution Certificate in your Apple Developer account.\nSaves the certificate with the private key to your ShipThis account",
       "examples": [
         "<%= config.bin %> <%= command.id %>",
         "<%= config.bin %> <%= command.id %> --force"
@@ -631,7 +782,7 @@
     "apple:certificate:status": {
       "aliases": [],
       "args": {},
-      "description": "Displays the status of the iOS Distribution certificates in your Apple and ShipThis accounts. These are used to sign all of your iOS apps.",
+      "description": "Displays the status of the iOS Distribution certificates in your Apple and ShipThis accounts.\nThese are used to sign all of your iOS apps.",
       "examples": [
         "<%= config.bin %> <%= command.id %>",
         "<%= config.bin %> <%= command.id %> --noAppleAuth"
@@ -794,155 +945,6 @@
         "list.js"
       ]
     },
-    "apple:apiKey:create": {
-      "aliases": [],
-      "args": {},
-      "description": "Creates an App Store Connect API Key in your Apple Developer account and saves the private key in your ShipThis account",
-      "examples": [
-        "<%= config.bin %> <%= command.id %>",
-        "<%= config.bin %> <%= command.id %> --force"
-      ],
-      "flags": {
-        "force": {
-          "char": "f",
-          "name": "force",
-          "allowNo": false,
-          "type": "boolean"
-        },
-        "quiet": {
-          "char": "q",
-          "description": "Avoid output except for interactions and errors",
-          "name": "quiet",
-          "allowNo": false,
-          "type": "boolean"
-        }
-      },
-      "hasDynamicHelp": false,
-      "hiddenAliases": [],
-      "id": "apple:apiKey:create",
-      "pluginAlias": "shipthis",
-      "pluginName": "shipthis",
-      "pluginType": "core",
-      "strict": true,
-      "isESM": true,
-      "relativePath": [
-        "dist",
-        "commands",
-        "apple",
-        "apiKey",
-        "create.js"
-      ]
-    },
-    "apple:apiKey:export": {
-      "aliases": [],
-      "args": {
-        "file": {
-          "description": "Name of the ZIP file to create",
-          "name": "file",
-          "required": true
-        }
-      },
-      "description": "Saves the current App Store Connect API Key to a ZIP file",
-      "examples": [
-        "<%= config.bin %> <%= command.id %> userApiKey.zip"
-      ],
-      "flags": {
-        "force": {
-          "char": "f",
-          "description": "Overwrite the file if it already exists",
-          "name": "force",
-          "allowNo": false,
-          "type": "boolean"
-        }
-      },
-      "hasDynamicHelp": false,
-      "hiddenAliases": [],
-      "id": "apple:apiKey:export",
-      "pluginAlias": "shipthis",
-      "pluginName": "shipthis",
-      "pluginType": "core",
-      "strict": true,
-      "enableJsonFlag": false,
-      "isESM": true,
-      "relativePath": [
-        "dist",
-        "commands",
-        "apple",
-        "apiKey",
-        "export.js"
-      ]
-    },
-    "apple:apiKey:import": {
-      "aliases": [],
-      "args": {
-        "file": {
-          "description": "Name of the ZIP file to import (must be in the same format as the export)",
-          "name": "file",
-          "required": true
-        }
-      },
-      "description": "Imports an App Store Connect API Key ZIP file into your ShipThis account",
-      "examples": [
-        "<%= config.bin %> <%= command.id %> userApiKey.zip"
-      ],
-      "flags": {
-        "force": {
-          "char": "f",
-          "name": "force",
-          "allowNo": false,
-          "type": "boolean"
-        }
-      },
-      "hasDynamicHelp": false,
-      "hiddenAliases": [],
-      "id": "apple:apiKey:import",
-      "pluginAlias": "shipthis",
-      "pluginName": "shipthis",
-      "pluginType": "core",
-      "strict": true,
-      "enableJsonFlag": false,
-      "isESM": true,
-      "relativePath": [
-        "dist",
-        "commands",
-        "apple",
-        "apiKey",
-        "import.js"
-      ]
-    },
-    "apple:apiKey:status": {
-      "aliases": [],
-      "args": {},
-      "description": "Displays the status of the App Store Connect API Keys in your Apple and ShipThis accounts. The API key is used to automatically publish your games to the App Store.",
-      "examples": [
-        "<%= config.bin %> <%= command.id %>",
-        "<%= config.bin %> <%= command.id %> --noAppleAuth"
-      ],
-      "flags": {
-        "noAppleAuth": {
-          "char": "f",
-          "name": "noAppleAuth",
-          "allowNo": false,
-          "type": "boolean"
-        }
-      },
-      "hasDynamicHelp": false,
-      "hiddenAliases": [],
-      "id": "apple:apiKey:status",
-      "pluginAlias": "shipthis",
-      "pluginName": "shipthis",
-      "pluginType": "core",
-      "strict": true,
-      "enableJsonFlag": false,
-      "isESM": true,
-      "relativePath": [
-        "dist",
-        "commands",
-        "apple",
-        "apiKey",
-        "status.js"
-      ]
-    },
     "game:ios:status": {
       "aliases": [],
       "args": {},
@@ -981,7 +983,7 @@
     "game:job:list": {
       "aliases": [],
       "args": {},
-      "description": "Lists the jobs for a game. If --gameId is not provided it will look in the current directory.",
+      "description": "Lists the jobs for a game.",
       "examples": [
         "<%= config.bin %> <%= command.id %>",
         "<%= config.bin %> <%= command.id %> --gameId 0c179fc4"
@@ -1177,7 +1179,7 @@
     "game:ios:app:create": {
       "aliases": [],
       "args": {},
-      "description": "Creates an App and BundleId in the Apple Developer Portal. If --gameId is not provided it will look in the current directory.",
+      "description": "Creates an App and BundleId in the Apple Developer Portal.",
       "examples": [
         "<%= config.bin %> <%= command.id %>"
       ],
@@ -1241,7 +1243,7 @@
     "game:ios:app:status": {
       "aliases": [],
       "args": {},
-      "description": "Shows the Game iOS App status. If --gameId is not provided it will look in the current directory.",
+      "description": "Shows the Game iOS App status. ",
       "examples": [
         "<%= config.bin %> <%= command.id %>"
       ],
@@ -1276,7 +1278,7 @@
     "game:ios:app:sync": {
       "aliases": [],
       "args": {},
-      "description": "Synchronies the Apple App \"BundleId\" with the capabilities from the local project. If --gameId is not provided it will look in the current directory.",
+      "description": "Synchronies the Apple App \"BundleId\" with the capabilities from the local project.",
       "examples": [
         "<%= config.bin %> <%= command.id %>"
       ],
@@ -1324,7 +1326,7 @@
     "game:ios:profile:create": {
       "aliases": [],
       "args": {},
-      "description": "Creates a Mobile Provisioning Profile in the Apple Developer Portal. If --gameId is not provided it will look in the current directory.",
+      "description": "Creates a Mobile Provisioning Profile in the Apple Developer Portal.",
       "examples": [
         "<%= config.bin %> <%= command.id %>"
       ],
@@ -1467,7 +1469,7 @@
     "game:ios:profile:status": {
       "aliases": [],
       "args": {},
-      "description": "Shows the Game iOS Mobile Provisioning Profile Status. If --gameId is not provided it will look in the current directory.",
+      "description": "Shows the Game iOS Mobile Provisioning Profile Status.",
       "examples": [
         "<%= config.bin %> <%= command.id %>"
       ],
@@ -1506,5 +1508,5 @@
       ]
     }
   },
-  "version": "0.0.9"
+  "version": "0.0.21"
 }

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "shipthis",
   "description": "Game Shipping Tool",
-  "version": "0.0.9",
+  "version": "0.0.21",
   "author": "Hello Invent Ltd",
   "bin": {
     "shipthis": "./bin/run.js"
@@ -41,6 +41,7 @@
     "@oclif/prettier-config": "^0.2.1",
     "@oclif/test": "^4",
     "@types/chai": "^4",
+    "@types/ejs": "^3.1.5",
     "@types/fs-extra": "^11.0.4",
     "@types/ini": "^4.1.1",
     "@types/jsonwebtoken": "^9.0.6",
@@ -54,6 +55,7 @@
     "@types/tough-cookie": "^4.0.5",
     "@types/yazl": "^2.4.5",
     "chai": "^4",
+    "ejs": "^3.1.10",
     "eslint": "^8",
     "eslint-config-oclif": "^5",
     "eslint-config-oclif-typescript": "^3",
@@ -73,6 +75,7 @@
   "files": [
     "/bin",
     "/dist",
+    "/docs",
     "/oclif.manifest.json"
   ],
   "homepage": "https://shipthis.cc",
@@ -83,6 +86,7 @@
   "main": "dist/index.js",
   "type": "module",
   "exports": [
+    "./dist/utils/help.js",
     "./dist/commands/apple/apiKey/export.js",
     "./dist/commands/apple/apiKey/status.js",
     "./dist/commands/apple/apiKey/create.js",
@@ -121,15 +125,25 @@
     "bin": "shipthis",
     "dirname": "shipthis",
     "commands": "./dist/commands",
+    "helpClass": "./dist/utils/help",
     "plugins": [
       "@oclif/plugin-help",
       "@oclif/plugin-plugins"
     ],
     "topicSeparator": " ",
     "topics": {
+      "internal": {
+        "description": "Internal commands"
+      },
       "apple": {
         "description": "Commands related to Apple Developer Portal"
       },
+      "apple:apiKey": {
+        "description": "Commands related to App Store Connect API Keys"
+      },
+      "apple:certificate": {
+        "description": "Commands related to App Store Certificates"
+      },
       "game": {
         "description": "Commands related to Game Management"
       },
@@ -158,9 +172,9 @@
     "lint": "eslint . --ext .ts",
     "postpack": "shx rm -f oclif.manifest.json",
     "posttest": "npm run lint",
-    "prepack": "oclif manifest && oclif readme",
+    "prepack": "npm run readme && oclif manifest",
     "test": "mocha --forbid-only \"test/**/*.test.ts\"",
-    "readme": "oclif readme --output-dir docs --multi --nested-topics-depth 2"
+    "readme": "bin/dev.js internal readme docs/ -d 2 --notDryRun # does not overwrite existing files"
   },
   "types": "dist/index.d.ts"
 }