Keep only listed root resources (#271)

* Suppress deep paths to unkept types
* Stub references with anonymous object
* Bump version and dependencies
* Also keep contained entities
* Keep types of contained entities
* Keep entity types contained in kept entity types
* Keep function import and its parameters and return types
* Ignore bound overloads for keeping return types
* Bound actions and functions
* Extract and test cli argument parsing

CHANGELOG.md

@@ -1,5 +1,16 @@
 # Changelog
 
+## [0.25.0] - 2024-01-12
+
+### Added
+
+- Command-line option `--keep` (short `-k`) to specify which root resources (entity sets, singletons, action imports, function imports) to keep.
+  - Paths for the root resources are kept, as are paths to contained entities and bound actions and functions.
+  - Types referenced by the (return) type of root resources via structural properties or containment navigation properties are also kept.
+  - Non-containment navigation properties to entity types not kept are changed to use a generic stub object type without properties.
+  - Deep paths to stubbed entity types are omitted.
+  - The `/$batch` resource is omitted.
+
 ## [0.24.2] - 2024-01-16
 
 ### Fixed

lib/README.md

@@ -38,6 +38,7 @@ Options:
  -d, --diagram           include YUML diagram
  -h, --help              show this info
  --host                  host (default: localhost)
+ -k, --keep              root resource to keep (can be specified multiple times with one name each)
  --levels                maximum number of path segments
  -o, --openapi-version   3.0.0 to 3.0.3 or 3.1.0 (default: 3.0.2)
  -p, --pretty            pretty-print JSON result

lib/cliParts.js

@@ -16,6 +16,7 @@ function parseArgs(argv) {
    -d, --diagram           include YUML diagram
    -h, --help              show this info
    --host                  host (default: localhost)
+   -k, --keep              root resource to keep (can be specified multiple times with one name each)
    --levels                maximum number of path segments
    -o, --openapi-version   3.0.0 to 3.0.3 or 3.1.0 (default: 3.0.2)
    -p, --pretty            pretty-print JSON result
@@ -30,6 +31,7 @@ function parseArgs(argv) {
       "basePath",
       "description",
       "host",
+      "keep",
       "levels",
       "openapi-version",
       "scheme",
@@ -40,6 +42,7 @@ function parseArgs(argv) {
     alias: {
       d: "diagram",
       h: "help",
+      k: "keep",
       o: "openapi-version",
       p: "pretty",
       t: "target",
@@ -77,6 +80,10 @@ function parseArgs(argv) {
       case "description":
         options.defaultDescription = value;
         break;
+      case "keep":
+        if (Array.isArray(value)) options.rootResourcesToKeep = value;
+        else options.rootResourcesToKeep = [value];
+        break;
       case "levels": {
         const l = Number(value);
         if (!isNaN(l)) options.maxLevels = l;