Add options for share json support

[nf-s]

Add options to support share json conversion

Mother issue - Model architecture: Share & story migration

For my assumptions - see https://github.com/TerriaJS/catalog-converter/blob/master/architecture/0001-share-conversion-assumptions.md

Main changes

• Add partial property in ConversionOption - this means that errors aren't thrown for required props (eg name or url)
• Add convertShare function with Share, ShareResult, and Story types
  • So far this seems to support everything except nested user-added-data groups (eg WMS-group) - but I'm sure we will find bugs as we continue testing.
• Add the following catalogMemberProps
  • { v7: "isShown", v8: "show" }
  • splitDirection

TerriaJS-Server changes

See TerriaJS/terriajs-server#119

Missing share properties:

• pickedFeatures - not in v8 share links (create or load)
• timeline - v7 timeline is different from v8
• locationMarker - not in v8
• sharedFromExplorerPanel - not in v8

This also contains WMS support (see #13 PR and #12 Issue)

[nf-s]

Currently user added data has duplicate models: This has been fixed, but left here for context

{
  "version": "8.0.0",
  "initSources": [
    {
      "stratum": "user",
      "models": {
        "//Example Datasets": {
          "type": "group",
          "isOpen": true,
          "knownContainerUniqueIds": [
            "/"
          ]
        },
        "__User-Added_Data__": {
          "type": "group",
          "name": "User-Added Data",
          "members": [
            {
              "type": "csv",
              "name": "http://localhost:3001/data/2011Census_TOT_LGA.csv",
              "description": "",
              "info": [],
              "show": true,
              "splitDirection": 0,
              "url": "http://localhost:3001/data/2011Census_TOT_LGA.csv",
              "opacity": 0.8
            }
          ],
          "description": "The group for data that was added by the user via the Add Data panel.",
          "info": [],
          "isOpen": true,
          "knownContainerUniqueIds": [
            "/"
          ]
        },
        "/http://localhost:3001/data/2011Census_TOT_LGA.csv": {
          "type": "csv",
          "name": "http://localhost:3001/data/2011Census_TOT_LGA.csv",
          "show": true,
          "splitDirection": 0,
          "url": "http://localhost:3001/data/2011Census_TOT_LGA.csv",
          "opacity": 0.8,
          "knownContainerUniqueIds": [
            "__User-Added_Data__"
          ]
        }
      },
      "stories": [],
      "workbench": [
        "/http://localhost:3001/data/2011Census_TOT_LGA.csv"
      ],

[nf-s]

My assumptions

Moved to https://github.com/TerriaJS/catalog-converter/blob/master/architecture/0001-share-conversion-assumptions.md

[soyarsauce]

Documenting this as you go is so great @nf-s - get them into an ADR (doesn't need to be perfect, just copy what you have in the PR into the .md) so that it lives in the repo as well.

[tephenavies]

This is great. There's a small number of changes needed.

[tephenavies]

Odd version number, to go from 0.0.2 to 0.0.2-alpha. Any reason? There's no good versioning policy for this repo yet so I'll take suggestions.

[nf-s]

I think @soyarsauce did this for terrace stuff

[tephenavies]

Thanks for the changes. Sorry that I didn't make it clear which mergeRecursive I was referring to.