@transcend-io/cli 4.55.0 → 4.57.0

package/README.md

@@ -21,50 +21,58 @@
     - [Authentication](#authentication-2)
     - [Usage](#usage-3)
     - [Arguments](#arguments-2)
-  - [tr-request-upload](#tr-request-upload)
+  - [tr-request-approve](#tr-request-approve)
     - [Authentication](#authentication-3)
     - [Arguments](#arguments-3)
     - [Usage](#usage-4)
-  - [tr-request-restart](#tr-request-restart)
+  - [tr-request-upload](#tr-request-upload)
     - [Authentication](#authentication-4)
     - [Arguments](#arguments-4)
     - [Usage](#usage-5)
-  - [tr-request-export](#tr-request-export)
+  - [tr-request-restart](#tr-request-restart)
     - [Authentication](#authentication-5)
     - [Arguments](#arguments-5)
     - [Usage](#usage-6)
-  - [tr-cron-pull-identifiers](#tr-cron-pull-identifiers)
+  - [tr-request-export](#tr-request-export)
     - [Authentication](#authentication-6)
     - [Arguments](#arguments-6)
     - [Usage](#usage-7)
-  - [tr-cron-mark-identifiers-completed](#tr-cron-mark-identifiers-completed)
+  - [tr-cron-pull-identifiers](#tr-cron-pull-identifiers)
     - [Authentication](#authentication-7)
     - [Arguments](#arguments-7)
     - [Usage](#usage-8)
-  - [tr-manual-enrichment-pull-identifiers](#tr-manual-enrichment-pull-identifiers)
+  - [tr-cron-mark-identifiers-completed](#tr-cron-mark-identifiers-completed)
     - [Authentication](#authentication-8)
     - [Arguments](#arguments-8)
     - [Usage](#usage-9)
-  - [tr-manual-enrichment-push-identifiers](#tr-manual-enrichment-push-identifiers)
+  - [tr-manual-enrichment-pull-identifiers](#tr-manual-enrichment-pull-identifiers)
     - [Authentication](#authentication-9)
     - [Arguments](#arguments-9)
     - [Usage](#usage-10)
-  - [tr-mark-request-data-silos-completed](#tr-mark-request-data-silos-completed)
+  - [tr-manual-enrichment-push-identifiers](#tr-manual-enrichment-push-identifiers)
     - [Authentication](#authentication-10)
     - [Arguments](#arguments-10)
     - [Usage](#usage-11)
-  - [tr-retry-request-data-silos](#tr-retry-request-data-silos)
+  - [tr-mark-request-data-silos-completed](#tr-mark-request-data-silos-completed)
     - [Authentication](#authentication-11)
     - [Arguments](#arguments-11)
     - [Usage](#usage-12)
-  - [tr-update-consent-manager](#tr-update-consent-manager)
+  - [tr-retry-request-data-silos](#tr-retry-request-data-silos)
     - [Authentication](#authentication-12)
     - [Arguments](#arguments-12)
     - [Usage](#usage-13)
-  - [tr-generate-api-keys](#tr-generate-api-keys)
+  - [tr-update-consent-manager](#tr-update-consent-manager)
     - [Authentication](#authentication-13)
     - [Arguments](#arguments-13)
     - [Usage](#usage-14)
+  - [tr-upload-data-flows-from-csv](#tr-upload-data-flows-from-csv)
+    - [Authentication](#authentication-14)
+    - [Arguments](#arguments-14)
+    - [Usage](#usage-15)
+  - [tr-generate-api-keys](#tr-generate-api-keys)
+    - [Authentication](#authentication-15)
+    - [Arguments](#arguments-15)
+    - [Usage](#usage-16)
 
 <!-- END doctoc generated TOC please keep comment here to allow auto update -->
 
@@ -86,6 +94,7 @@ yarn add -D @transcend-io/cli
 yarn tr-pull --auth=$TRANSCEND_API_KEY
 yarn tr-push --auth=$TRANSCEND_API_KEY
 yarn tr-discover-silos --auth=$TRANSCEND_API_KEY
+yarn tr-request-approve --auth=$TRANSCEND_API_KEY
 yarn tr-request-upload --auth=$TRANSCEND_API_KEY
 yarn tr-request-export --auth=$TRANSCEND_API_KEY
 yarn tr-request-restart --auth=$TRANSCEND_API_KEY
@@ -95,6 +104,7 @@ yarn tr-manual-enrichment-pull-identifiers --auth=$TRANSCEND_API_KEY
 yarn tr-mark-request-data-silos-completed --auth=$TRANSCEND_API_KEY
 yarn tr-retry-request-data-silos --auth=$TRANSCEND_API_KEY
 yarn tr-update-consent-manager --auth=$TRANSCEND_API_KEY
+yarn tr-upload-data-flows-from-csv --auth=$TRANSCEND_API_KEY
 yarn tr-generate-api-keys --auth=$TRANSCEND_API_KEY
 ```
 
@@ -108,6 +118,7 @@ npm i -D @transcend-io/cli
 tr-pull --auth=$TRANSCEND_API_KEY
 tr-push --auth=$TRANSCEND_API_KEY
 tr-discover-silos --auth=$TRANSCEND_API_KEY
+tr-request-approve --auth=$TRANSCEND_API_KEY
 tr-request-upload --auth=$TRANSCEND_API_KEY
 tr-request-export --auth=$TRANSCEND_API_KEY
 tr-request-restart --auth=$TRANSCEND_API_KEY
@@ -117,6 +128,7 @@ tr-manual-enrichment-pull-identifiers --auth=$TRANSCEND_API_KEY
 tr-mark-request-data-silos-completed --auth=$TRANSCEND_API_KEY
 tr-retry-request-data-silos --auth=$TRANSCEND_API_KEY
 tr-update-consent-manager --auth=$TRANSCEND_API_KEY
+tr-upload-data-flows-from-csv --auth=$TRANSCEND_API_KEY
 tr-generate-api-keys --auth=$TRANSCEND_API_KEY
 ```
 
@@ -128,17 +140,12 @@ npm i -g @transcend-io/cli
 
 # cli commands available everywhere on machine
 tr-pull --auth=$TRANSCEND_API_KEY
-tr-push --auth=$TRANSCEND_API_KEY
-tr-discover-silos --auth=$TRANSCEND_API_KEY
-tr-request-upload --auth=$TRANSCEND_API_KEY
-tr-request-restart --auth=$TRANSCEND_API_KEY
-tr-cron-pull-identifiers --auth=$TRANSCEND_API_KEY
-tr-cron-mark-identifiers-completed --auth=$TRANSCEND_API_KEY
+...
 ```
 
 Note:
 
-_The cli-commands default to using the EU Transcend backend. To use these commands with the US backend, you will need to use the flag --transcendUrl=https://api.us.transend.io._
+_The cli-commands default to using the EU Transcend backend. To use these commands with the US backend, you will need to use the flag --transcendUrl=https://api.us.transcend.io._
 
 ## transcend.yml
 
@@ -271,7 +278,7 @@ _Note: The scopes for tr-push are comprehensive of the scopes for tr-pull_
 
 | Argument         | Description                                                                              | Type                                                         | Default                               | Required |
 | ---------------- | ---------------------------------------------------------------------------------------- | ------------------------------------------------------------ | ------------------------------------- | -------- |
-| auth             | The Transcend API capable of fetching the configuration                                  | string (API key or path to tr-generate-api-keys JSON output) | N/A                                   | true     |
+| auth             | The Transcend API key with the scopes necessary for the command.                         | string (API key or path to tr-generate-api-keys JSON output) | N/A                                   | true     |
 | resources        | The different resource types to pull in (see table above for breakdown of each resource) | string                                                       | apiKeys,templates,dataSilos,enrichers | false    |
 | file             | Path to the YAML file to pull into                                                       | string - file-path                                           | ./transcend.yml                       | false    |
 | transcendUrl     | URL of the Transcend backend. Use https://api.us.transcend.io for US hosting.            | string - URL                                                 | https://api.transcend.io              | false    |
@@ -418,12 +425,12 @@ The API key needs the following scopes when pushing the various resource types:
 
 | Argument        | Description                                                                                                 | Type                                                         | Default                  | Required |
 | --------------- | ----------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------ | ------------------------ | -------- |
-| auth            | The Transcend API capable of pushing the configuration                                                      | string (API key or path to tr-generate-api-keys JSON output) | N/A                      | true     |
+| auth            | The Transcend API key with the scopes necessary for the command.                                            | string (API key or path to tr-generate-api-keys JSON output) | N/A                      | true     |
 | file            | Path to the YAML file to push from                                                                          | string - file-path                                           | ./transcend.yml          | false    |
 | transcendUrl    | URL of the Transcend backend. Use https://api.us.transcend.io for US hosting.                               | string - URL                                                 | https://api.transcend.io | false    |
 | pageSize        | The page size to use when paginating over the API                                                           | number                                                       | 50                       | false    |
 | variables       | The variables to template into the YAML file when pushing configuration. e.g. domain:acme.com,stage:staging | string                                                       | N/A                      | false    |
-| classifyService | classify data flow service if missing                                                                       | boolean                                                      | false                    | false    |
+| classifyService | When true, automatically assign the service for a data flow based on the domain that is specified           | boolean                                                      | false                    | false    |
 
 #### Usage
 
@@ -594,6 +601,56 @@ You can include additional arguments as well:
 | auth       | Transcend API key.                                                                                                                                                   | string | N/A     | true     |
 | fileGlobs  | You can pass a [glob syntax pattern(s)](https://github.com/mrmlnc/fast-glob) to specify additional file paths to scan in addition to the default (ex: package.json). | string | N/A     | false    |
 
+### tr-request-approve
+
+Bulk approve a set of privacy requests from the [Privacy Requests -> Incoming Requests](https://app.transcend.io/privacy-requests/incoming-requests) tab.
+
+#### Authentication
+
+In order to use this cli, you will first need to generate an API key on the Transcend Admin Dashboard (https://app.transcend.io/infrastructure/api-keys).
+
+The API key needs the following scopes:
+
+- Request Approval and Communication
+- View Incoming Requests
+- Manage Request Compilation
+
+#### Arguments
+
+| Argument         | Description                                                                                                                                | Type            | Default                  | Required |
+| ---------------- | ------------------------------------------------------------------------------------------------------------------------------------------ | --------------- | ------------------------ | -------- |
+| auth             | The Transcend API key with the scopes necessary for the command.                                                                           | string          | N/A                      | true     |
+| actions          | The [request actions](https://docs.transcend.io/docs/privacy-requests/configuring-requests/data-subject-requests#data-actions) to approve. | RequestAction[] | N/A                      | true     |
+| silentModeBefore | Any requests made before this date should be marked as silent mode                                                                         | Date            | N/A                      | false    |
+| transcendUrl     | URL of the Transcend backend. Use https://api.us.transcend.io for US hosting.                                                              | string - URL    | https://api.transcend.io | false    |
+| concurrency      | The concurrency to use when uploading requests in parallel.                                                                                | number          | 100                      | false    |
+
+#### Usage
+
+Bulk approve all SALE_OPT_OUT and ERASURE requests
+
+```sh
+yarn tr-request-approve --auth=$TRANSCEND_API_KEY --actions=SALE_OPT_OUT,ERASURE
+```
+
+Specifying the backend URL, needed for US hosted backend infrastructure.
+
+```sh
+yarn tr-request-approve --auth=$TRANSCEND_API_KEY --actions=ERASURE --transcendUrl=https://api.us.transcend.io
+```
+
+Approve all requests, but mark any request made before 05/03/2023 as silent mode to prevent emailing the individual.
+
+```sh
+yarn tr-request-approve --auth=$TRANSCEND_API_KEY --actions=SALE_OPT_OUT --silentModeBefore=05/03/2023
+```
+
+Increase the concurrency (defaults to 100)
+
+```sh
+yarn tr-request-approve --auth=$TRANSCEND_API_KEY --actions=ERASURE --concurrency=500
+```
+
 ### tr-request-upload
 
 If you need to upload a set of requests from a CSV, you can run this command.
@@ -625,7 +682,7 @@ The API key needs the following scopes:
 
 | Argument                | Description                                                                                                             | Type               | Default                                 | Required |
 | ----------------------- | ----------------------------------------------------------------------------------------------------------------------- | ------------------ | --------------------------------------- | -------- |
-| auth                    | The Transcend API capable of submitting privacy requests.                                                               | string             | N/A                                     | true     |
+| auth                    | The Transcend API key with the scopes necessary for the command.                                                        | string             | N/A                                     | true     |
 | file                    | Path to the CSV file of requests to tupload.                                                                            | string - file-path | ./requests.csv                          | false    |
 | transcendUrl            | URL of the Transcend backend. Use https://api.us.transcend.io for US hosting.                                           | string - URL       | https://api.transcend.io                | false    |
 | cacheFilepath           | The path to the JSON file encoding the metadata used to map the CSV shape to Transcend API.                             | string             | ./transcend-privacy-requests-cache.json | false    |
@@ -733,7 +790,7 @@ The API key needs the following scopes:
 
 | Argument             | Description                                                                                                                               | Type            | Default                           | Required |
 | -------------------- | ----------------------------------------------------------------------------------------------------------------------------------------- | --------------- | --------------------------------- | -------- |
-| auth                 | The Transcend API capable of submitting privacy requests.                                                                                 | string          | N/A                               | true     |
+| auth                 | The Transcend API key with the scopes necessary for the command.                                                                          | string          | N/A                               | true     |
 | actions              | The [request action](https://docs.transcend.io/docs/privacy-requests/configuring-requests/data-subject-requests#data-actions) to restart. | RequestAction[] | N/A                               | true     |
 | statuses             | The [request statuses](https://docs.transcend.io/docs/privacy-requests/overview#request-statuses) to restart.                             | RequestStatus[] | N/A                               | true     |
 | transcendUrl         | URL of the Transcend backend. Use https://api.us.transcend.io for US hosting.                                                             | string - URL    | https://api.transcend.io          | false    |
@@ -832,7 +889,7 @@ The API key needs the following scopes:
 
 | Argument        | Description                                                                                                                               | Type               | Default                        | Required |
 | --------------- | ----------------------------------------------------------------------------------------------------------------------------------------- | ------------------ | ------------------------------ | -------- |
-| auth            | The Transcend API capable of pulling privacy requests.                                                                                    | string             | N/A                            | true     |
+| auth            | The Transcend API key with the scopes necessary for the command.                                                                          | string             | N/A                            | true     |
 | actions         | The [request action](https://docs.transcend.io/docs/privacy-requests/configuring-requests/data-subject-requests#data-actions) to restart. | RequestAction[]    | N/A                            | false    |
 | statuses        | The [request statuses](https://docs.transcend.io/docs/privacy-requests/overview#request-statuses) to restart.                             | RequestStatus[]    | N/A                            | false    |
 | transcendUrl    | URL of the Transcend backend. Use https://api.us.transcend.io for US hosting.                                                             | string - URL       | https://api.transcend.io       | false    |
@@ -905,7 +962,7 @@ The API key must be associated to the ID of the integration/data silo that is be
 
 | Argument     | Description                                                                                                                             | Type                   | Default                  | Required |
 | ------------ | --------------------------------------------------------------------------------------------------------------------------------------- | ---------------------- | ------------------------ | -------- |
-| auth         | The Transcend API capable of pulling the cron identifiers.                                                                              | string                 | N/A                      | true     |
+| auth         | The Transcend API key with the scopes necessary for the command.                                                                        | string                 | N/A                      | true     |
 | dataSiloId   | The ID of the data silo to pull in.                                                                                                     | string - UUID          | N/A                      | true     |
 | requestType  | The [request action](https://docs.transcend.io/docs/privacy-requests/configuring-requests/data-subject-requests#data-actions) to fetch. | string - RequestAction | N/A                      | true     |
 | file         | Path to the CSV file where identifiers will be written to.                                                                              | string - file-path     | ./cron-identifiers.csv   | false    |
@@ -970,7 +1027,7 @@ The API key must be associated to the ID of the integration/data silo that is be
 
 | Argument     | Description                                                                          | Type               | Default                  | Required |
 | ------------ | ------------------------------------------------------------------------------------ | ------------------ | ------------------------ | -------- |
-| auth         | The Transcend API capable of pulling the cron identifiers.                           | string             | N/A                      | true     |
+| auth         | The Transcend API key with the scopes necessary for the command.                     | string             | N/A                      | true     |
 | dataSiloId   | The ID of the data silo to pull in.                                                  | string - UUID      | N/A                      | true     |
 | file         | Path to the CSV file where identifiers will be written to.                           | string - file-path | ./cron-identifiers.csv   | false    |
 | transcendUrl | URL of the Transcend backend. Use https://api.us.transcend.io for US hosting.        | string - URL       | https://api.transcend.io | false    |
@@ -1028,7 +1085,7 @@ The API key must have the following scopes:
 
 | Argument     | Description                                                                   | Type               | Default                             | Required |
 | ------------ | ----------------------------------------------------------------------------- | ------------------ | ----------------------------------- | -------- |
-| auth         | The Transcend API capable of pull request information.                        | string             | N/A                                 | true     |
+| auth         | The Transcend API key with the scopes necessary for the command.              | string             | N/A                                 | true     |
 | transcendUrl | URL of the Transcend backend. Use https://api.us.transcend.io for US hosting. | string - URL       | https://api.transcend.io            | false    |
 | file         | Path to the CSV file where requests will be written to.                       | string - file-path | ./manual-enrichment-identifiers.csv | false    |
 | actions      | The set of request actions to pull requests for.                              | RequestAction[]    | []                                  | false    |
@@ -1088,7 +1145,7 @@ The API key must have the following scopes:
 
 | Argument     | Description                                                                          | Type               | Default                             | Required |
 | ------------ | ------------------------------------------------------------------------------------ | ------------------ | ----------------------------------- | -------- |
-| auth         | The Transcend API capable of pull request information.                               | string             | N/A                                 | true     |
+| auth         | The Transcend API key with the scopes necessary for the command.                     | string             | N/A                                 | true     |
 | enricherId   | The ID of the Request Enricher to upload to                                          | string - UUID      | N/A                                 | true     |
 | sombraAuth   | The sombra internal key, use for additional authentication when self-hosting sombra. | string             | N/A                                 | false    |
 | transcendUrl | URL of the Transcend backend. Use https://api.us.transcend.io for US hosting.        | string - URL       | https://api.transcend.io            | false    |
@@ -1142,7 +1199,7 @@ The API key must have the following scopes:
 
 | Argument     | Description                                                                   | Type               | Default                   | Required |
 | ------------ | ----------------------------------------------------------------------------- | ------------------ | ------------------------- | -------- |
-| auth         | The Transcend API capable of pulling the cron identifiers.                    | string             | N/A                       | true     |
+| auth         | The Transcend API key with the scopes necessary for the command.              | string             | N/A                       | true     |
 | dataSiloId   | The ID of the data silo to pull in.                                           | string - UUID      | N/A                       | true     |
 | file         | Path to the CSV file where identifiers will be written to.                    | string - file-path | ./request-identifiers.csv | false    |
 | transcendUrl | URL of the Transcend backend. Use https://api.us.transcend.io for US hosting. | string - URL       | https://api.transcend.io  | false    |
@@ -1183,7 +1240,7 @@ The API key must have the following scopes:
 
 | Argument     | Description                                                                                                                               | Type            | Default                  | Required |
 | ------------ | ----------------------------------------------------------------------------------------------------------------------------------------- | --------------- | ------------------------ | -------- |
-| auth         | The Transcend API capable of pulling the cron identifiers.                                                                                | string          | N/A                      | true     |
+| auth         | The Transcend API key with the scopes necessary for the command.                                                                          | string          | N/A                      | true     |
 | dataSiloId   | The ID of the data silo to pull in.                                                                                                       | string - UUID   | N/A                      | true     |
 | actions      | The [request action](https://docs.transcend.io/docs/privacy-requests/configuring-requests/data-subject-requests#data-actions) to restart. | RequestAction[] | N/A                      | true     |
 | transcendUrl | URL of the Transcend backend. Use https://api.us.transcend.io for US hosting.                                                             | string - URL    | https://api.transcend.io | false    |
@@ -1217,9 +1274,9 @@ The API key must have the following scopes:
 
 | Argument     | Description                                                                   | Type         | Default                  | Required |
 | ------------ | ----------------------------------------------------------------------------- | ------------ | ------------------------ | -------- |
-| auth         | The Transcend API capable of pulling the cron identifiers.                    | string       | N/A                      | true     |
+| auth         | The Transcend API key with the scopes necessary for the command.              | string       | N/A                      | true     |
 | bundleTypes  | The bundle types to deploy                                                    | BundleType[] | PRODUCTION,TEST          | false    |
-| deokiy       | When true, deploy the Consent Manager after updating the version              | boolean      | false                    | false    |
+| deploy       | When true, deploy the Consent Manager after updating the version              | boolean      | false                    | false    |
 | transcendUrl | URL of the Transcend backend. Use https://api.us.transcend.io for US hosting. | string - URL | https://api.transcend.io | false    |
 
 #### Usage
@@ -1261,6 +1318,70 @@ tr-generate-api-keys  --email=test@transcend.io --password=$TRANSCEND_PASSWORD -
 yarn tr-update-consent-manager  --auth=./transcend-api-keys.json --deploy=true
 ```
 
+### tr-upload-data-flows-from-csv
+
+This command allows for uploading of data flows from CSV.
+
+Step 1) Download the CSV of data flows that you want to edit from the Admin Dashboard under [Consent Manager -> Data Flows](https://app.transcend.io/consent-manager/data-flows). You can download data flows from both the "Triage" and "Approved" tabs.
+
+<img width="1464" alt="Screenshot 2023-06-22 at 6 05 36 PM" src="https://github.com/transcend-io/cli/assets/10264973/c4b65b31-2cf3-49c9-b543-041567c7aff8">
+
+Step 2) You can edit the contents of the CSV file as needed. You may adjust the "Purpose" column, adjust the "Notes" column, add "Owners" and "Teams" or even add custom columns with additional metadata.
+
+Step 3) Upload the modified CSV file back into the dashboard with the command `yarn tr-upload-data-flows-from-csv --auth=$TRANSCEND_API_KEY --file=./approved-flows.csv --trackerStatus=LIVE`
+
+#### Authentication
+
+In order to use this cli, you will first need to generate an API key on the Transcend Admin Dashboard (https://app.transcend.io/infrastructure/api-keys).
+
+The API key must have the following scopes:
+
+- "Manage Data Flows"
+
+#### Arguments
+
+| Argument        | Description                                                                                                | Type                 | Default                  | Required |
+| --------------- | ---------------------------------------------------------------------------------------------------------- | -------------------- | ------------------------ | -------- |
+| auth            | The Transcend API key with the scopes necessary for the command.                                           | string               | N/A                      | true     |
+| trackerStatus   | Whether or not to upload the data flows into the "Approved" tab (LIVE) or the "Triage" tab (NEEDS_REVIEW). | ConsentTrackerStatus | N/A                      | true     |
+| file            | Path to the CSV file to upload                                                                             | string - file-path   | ./data-flows.csv         | false    |
+| classifyService | When true, automatically assign the service for a data flow based on the domain that is specified          | boolean              | false                    | false    |
+| transcendUrl    | URL of the Transcend backend. Use https://api.us.transcend.io for US hosting.                              | string - URL         | https://api.transcend.io | false    |
+
+Note: You `trackerStatus` can be specified on a per data flow basis by adding a column named "Status" to the CSV. The values should be of type `ConsentTrackerStatus` - which is `LIVE` or `NEEDS_REVIEW`.
+
+#### Usage
+
+Upload the file of data flows in `./data-flows.csv` into the ["Approved" tab](https://app.transcend.io/consent-manager/data-flows/approved).
+
+```sh
+yarn tr-upload-data-flows-from-csv --auth=$TRANSCEND_API_KEY --trackerStatus=LIVE
+```
+
+Upload the file of data flows in `./data-flows.csv` into the ["Triage" tab](https://app.transcend.io/consent-manager/data-flows).
+
+```sh
+yarn tr-upload-data-flows-from-csv --auth=$TRANSCEND_API_KEY --trackerStatus=NEEDS_REVIEW
+```
+
+Specifying the CSV file to read from:
+
+```sh
+yarn tr-upload-data-flows-from-csv --auth=$TRANSCEND_API_KEY --trackerStatus=LIVE --file=./custom/my-data-flows.csv
+```
+
+Have Transcend automatically fill in the service names by looking up the data flow host in Transcend's database.
+
+```sh
+yarn tr-upload-data-flows-from-csv --auth=$TRANSCEND_API_KEY --trackerStatus=LIVE --classifyService=true
+```
+
+Specifying the backend URL, needed for US hosted backend infrastructure.
+
+```sh
+yarn tr-upload-data-flows-from-csv --auth=$TRANSCEND_API_KEY --transcendUrl=https://api.us.transcend.io
+```
+
 ### tr-generate-api-keys
 
 This command allows for creating API keys across multiple Transcend instances. This is useful for customers that are managing many Transcend instances and need to regularly create, cycle or delete API keys across all of their instances. Unlike the other commands that rely on API key authentication, this command relies upon username/password authentication. This command will spit out the API keys into a [JSON file](./examples/api-keys.json), and that JSON file can be used in subsequent cli commands.

package/build/cli-request-approve.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+export {};
+//# sourceMappingURL=cli-request-approve.d.ts.map

package/build/cli-request-approve.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli-request-approve.d.ts","sourceRoot":"","sources":["../src/cli-request-approve.ts"],"names":[],"mappings":""}

package/build/cli-request-approve.js

@@ -0,0 +1,56 @@
+#!/usr/bin/env node
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+const yargs_parser_1 = __importDefault(require("yargs-parser"));
+const colors_1 = __importDefault(require("colors"));
+const logger_1 = require("./logger");
+const privacy_types_1 = require("@transcend-io/privacy-types");
+const requests_1 = require("./requests");
+/**
+ * Restart requests based on some filter criteria
+ *
+ * Requires scopes:
+ * - Request Approval and Communication
+ * - View Incoming Requests
+ * - Manage Request Compilation
+ *
+ * Dev Usage:
+ * yarn ts-node ./src/cli-request-approve.ts --auth=asd123 \
+ *   --requestType=ERASURE --silentModeBefore=06/23/2023
+ *
+ * Standard usage:
+ * yarn tr-request-export --auth=asd123  \
+ *   --requestType=ERASURE --silentModeBefore=06/23/2023
+ */
+async function main() {
+    // Parse command line arguments
+    const { transcendUrl = 'https://api.transcend.io', auth, actions = '', silentModeBefore, concurrency = '100', } = (0, yargs_parser_1.default)(process.argv.slice(2));
+    // Ensure auth is passed
+    if (!auth) {
+        logger_1.logger.error(colors_1.default.red('A Transcend API key must be provided. You can specify using --auth=asd123'));
+        process.exit(1);
+    }
+    // Validate actions
+    const parsedActions = (0, requests_1.splitCsvToList)(actions);
+    const invalidActions = parsedActions.filter(
+    // eslint-disable-next-line @typescript-eslint/no-explicit-any
+    (type) => !Object.values(privacy_types_1.RequestAction).includes(type));
+    if (invalidActions.length > 0) {
+        logger_1.logger.error(colors_1.default.red(`Failed to parse actions:"${invalidActions.join(',')}".\n` +
+            `Expected one of: \n${Object.values(privacy_types_1.RequestAction).join('\n')}`));
+        process.exit(1);
+    }
+    // Pull privacy requests
+    await (0, requests_1.approvePrivacyRequests)({
+        transcendUrl,
+        requestActions: parsedActions,
+        auth,
+        concurrency: parseInt(concurrency, 10),
+        silentModeBefore: silentModeBefore ? new Date(silentModeBefore) : undefined,
+    });
+}
+main();
+//# sourceMappingURL=cli-request-approve.js.map

package/build/cli-request-approve.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli-request-approve.js","sourceRoot":"","sources":["../src/cli-request-approve.ts"],"names":[],"mappings":";;;;;;AAEA,gEAAiC;AACjC,oDAA4B;AAE5B,qCAAkC;AAClC,+DAA4D;AAC5D,yCAAoE;AAEpE;;;;;;;;;;;;;;;GAeG;AACH,KAAK,UAAU,IAAI;IACjB,+BAA+B;IAC/B,MAAM,EACJ,YAAY,GAAG,0BAA0B,EACzC,IAAI,EACJ,OAAO,GAAG,EAAE,EACZ,gBAAgB,EAChB,WAAW,GAAG,KAAK,GACpB,GAAG,IAAA,sBAAK,EAAC,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAA8B,CAAC;IAE9D,wBAAwB;IACxB,IAAI,CAAC,IAAI,EAAE;QACT,eAAM,CAAC,KAAK,CACV,gBAAM,CAAC,GAAG,CACR,2EAA2E,CAC5E,CACF,CAAC;QACF,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;KACjB;IAED,mBAAmB;IACnB,MAAM,aAAa,GAAG,IAAA,yBAAc,EAAC,OAAO,CAAoB,CAAC;IACjE,MAAM,cAAc,GAAG,aAAa,CAAC,MAAM;IACzC,8DAA8D;IAC9D,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,MAAM,CAAC,MAAM,CAAC,6BAAa,CAAC,CAAC,QAAQ,CAAC,IAAW,CAAC,CAC9D,CAAC;IACF,IAAI,cAAc,CAAC,MAAM,GAAG,CAAC,EAAE;QAC7B,eAAM,CAAC,KAAK,CACV,gBAAM,CAAC,GAAG,CACR,4BAA4B,cAAc,CAAC,IAAI,CAAC,GAAG,CAAC,MAAM;YACxD,sBAAsB,MAAM,CAAC,MAAM,CAAC,6BAAa,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAClE,CACF,CAAC;QACF,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;KACjB;IAED,wBAAwB;IACxB,MAAM,IAAA,iCAAsB,EAAC;QAC3B,YAAY;QACZ,cAAc,EAAE,aAAa;QAC7B,IAAI;QACJ,WAAW,EAAE,QAAQ,CAAC,WAAW,EAAE,EAAE,CAAC;QACtC,gBAAgB,EAAE,gBAAgB,CAAC,CAAC,CAAC,IAAI,IAAI,CAAC,gBAAgB,CAAC,CAAC,CAAC,CAAC,SAAS;KAC5E,CAAC,CAAC;AACL,CAAC;AAED,IAAI,EAAE,CAAC"}

package/build/cli-upload-data-flows-from-csv.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+export {};
+//# sourceMappingURL=cli-upload-data-flows-from-csv.d.ts.map

package/build/cli-upload-data-flows-from-csv.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli-upload-data-flows-from-csv.d.ts","sourceRoot":"","sources":["../src/cli-upload-data-flows-from-csv.ts"],"names":[],"mappings":""}

package/build/cli-upload-data-flows-from-csv.js

@@ -0,0 +1,59 @@
+#!/usr/bin/env node
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+const yargs_parser_1 = __importDefault(require("yargs-parser"));
+const colors_1 = __importDefault(require("colors"));
+const logger_1 = require("./logger");
+const consent_manager_1 = require("./consent-manager");
+const privacy_types_1 = require("@transcend-io/privacy-types");
+/**
+ * Upload a CSV of data flows
+ *
+ * Requires an API key with follow scopes: https://app.transcend.io/infrastructure/api-keys
+ *    - "Manage Data Flows"
+ *
+ * Dev Usage:
+ * yarn ts-node ./src/cli-upload-data-flows-from-csv.ts --auth=asd123 \
+ *   --file=/Users/michaelfarrell/Desktop/test.csv \
+ *   --trackerStatus=LIVE
+ *
+ * Standard usage:
+ * yarn tr-upload-data-flows-from-csv --auth=asd123 \
+ *   --file=/Users/michaelfarrell/Desktop/test.csv \
+ *   --trackerStatus=LIVE
+ */
+async function main() {
+    // Parse command line arguments
+    const { auth, trackerStatus, classifyService = 'false', file = './data-flows.csv', transcendUrl = 'https://api.transcend.io', } = (0, yargs_parser_1.default)(process.argv.slice(2));
+    // Ensure auth is passed
+    if (!auth) {
+        logger_1.logger.error(colors_1.default.red('A Transcend API key must be provided. You can specify using --auth=asd123'));
+        process.exit(1);
+    }
+    // Ensure trackerStatus is passed
+    const VALID_TRACKER_OPTIONS = Object.values(privacy_types_1.ConsentTrackerStatus);
+    if (!trackerStatus) {
+        logger_1.logger.error(colors_1.default.red('The trackerStatus must be provided. You can specify using --trackerStatus=LIVE. ' +
+            `Valid options include: ${VALID_TRACKER_OPTIONS.join(',')}`));
+        process.exit(1);
+    }
+    const consentTrackerStatus = trackerStatus;
+    if (!VALID_TRACKER_OPTIONS.includes(consentTrackerStatus)) {
+        logger_1.logger.error(colors_1.default.red(`The trackerStatus option was invalid, got: "${trackerStatus}". You can specify using --trackerStatus=LIVE. ` +
+            `Valid options include: ${VALID_TRACKER_OPTIONS.join(',')}`));
+        process.exit(1);
+    }
+    // Upload data flows
+    await (0, consent_manager_1.uploadDataFlowsFromCsv)({
+        auth,
+        trackerStatus: consentTrackerStatus,
+        file,
+        classifyService: classifyService === 'true',
+        transcendUrl,
+    });
+}
+main();
+//# sourceMappingURL=cli-upload-data-flows-from-csv.js.map

package/build/cli-upload-data-flows-from-csv.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli-upload-data-flows-from-csv.js","sourceRoot":"","sources":["../src/cli-upload-data-flows-from-csv.ts"],"names":[],"mappings":";;;;;;AAEA,gEAAiC;AACjC,oDAA4B;AAE5B,qCAAkC;AAClC,uDAA2D;AAC3D,+DAAmE;AAEnE;;;;;;;;;;;;;;;GAeG;AACH,KAAK,UAAU,IAAI;IACjB,+BAA+B;IAC/B,MAAM,EACJ,IAAI,EACJ,aAAa,EACb,eAAe,GAAG,OAAO,EACzB,IAAI,GAAG,kBAAkB,EACzB,YAAY,GAAG,0BAA0B,GAC1C,GAAG,IAAA,sBAAK,EAAC,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAA8B,CAAC;IAE9D,wBAAwB;IACxB,IAAI,CAAC,IAAI,EAAE;QACT,eAAM,CAAC,KAAK,CACV,gBAAM,CAAC,GAAG,CACR,2EAA2E,CAC5E,CACF,CAAC;QACF,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;KACjB;IAED,iCAAiC;IACjC,MAAM,qBAAqB,GAAG,MAAM,CAAC,MAAM,CAAC,oCAAoB,CAAC,CAAC;IAClE,IAAI,CAAC,aAAa,EAAE;QAClB,eAAM,CAAC,KAAK,CACV,gBAAM,CAAC,GAAG,CACR,kFAAkF;YAChF,0BAA0B,qBAAqB,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAC9D,CACF,CAAC;QACF,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;KACjB;IAED,MAAM,oBAAoB,GAAG,aAAqC,CAAC;IACnE,IAAI,CAAC,qBAAqB,CAAC,QAAQ,CAAC,oBAAoB,CAAC,EAAE;QACzD,eAAM,CAAC,KAAK,CACV,gBAAM,CAAC,GAAG,CACR,+CAA+C,aAAa,iDAAiD;YAC3G,0BAA0B,qBAAqB,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAC9D,CACF,CAAC;QACF,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;KACjB;IAED,oBAAoB;IACpB,MAAM,IAAA,wCAAsB,EAAC;QAC3B,IAAI;QACJ,aAAa,EAAE,oBAAoB;QACnC,IAAI;QACJ,eAAe,EAAE,eAAe,KAAK,MAAM;QAC3C,YAAY;KACb,CAAC,CAAC;AACL,CAAC;AAED,IAAI,EAAE,CAAC"}

package/build/consent-manager/index.d.ts

@@ -1,2 +1,3 @@
 export * from './updateConsentManagerVersionToLatest';
+export * from './uploadDataFlowsFromCsv';
 //# sourceMappingURL=index.d.ts.map

package/build/consent-manager/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/consent-manager/index.ts"],"names":[],"mappings":"AAAA,cAAc,uCAAuC,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/consent-manager/index.ts"],"names":[],"mappings":"AAAA,cAAc,uCAAuC,CAAC;AACtD,cAAc,0BAA0B,CAAC"}

package/build/consent-manager/index.js

@@ -15,4 +15,5 @@ var __exportStar = (this && this.__exportStar) || function(m, exports) {
 };
 Object.defineProperty(exports, "__esModule", { value: true });
 __exportStar(require("./updateConsentManagerVersionToLatest"), exports);
+__exportStar(require("./uploadDataFlowsFromCsv"), exports);
 //# sourceMappingURL=index.js.map

package/build/consent-manager/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/consent-manager/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,wEAAsD"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/consent-manager/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,wEAAsD;AACtD,2DAAyC"}

package/build/consent-manager/uploadDataFlowsFromCsv.d.ts

@@ -0,0 +1,53 @@
+import * as t from 'io-ts';
+import { ConsentTrackerStatus } from '@transcend-io/privacy-types';
+/**
+ * Minimal set required to mark as completed
+ */
+export declare const DataFlowCsvInput: t.IntersectionC<[t.TypeC<{
+    /** The value of the data flow (host or regex) */
+    'Connections Made To': t.StringC;
+    /** The type of the data flow */
+    Type: t.KeyofC<{
+        HOST: unknown;
+        PATH: unknown;
+        QUERY_PARAM: unknown;
+        REGEX: unknown;
+        CSP: unknown;
+    }>;
+    /** The CSV of purposes mapped to that data flow */
+    Purpose: t.StringC;
+}>, t.PartialC<{
+    /** The service that the data flow relates to */
+    Service: t.StringC;
+    /** Notes and descriptions for the data flow */
+    Notes: t.StringC;
+    /** Set of data flow owners */
+    Owners: t.StringC;
+    /** Set of data flow team owners */
+    Teams: t.StringC;
+    /** LIVE vs NEEDS_REVIEW aka Approved vs Triage  */
+    Status: t.KeyofC<{
+        LIVE: unknown;
+        NEEDS_REVIEW: unknown;
+    }>;
+}>, t.RecordC<t.StringC, t.StringC>]>;
+/** Type override */
+export type DataFlowCsvInput = t.TypeOf<typeof DataFlowCsvInput>;
+/**
+ * Upload a set of data flows from CSV
+ *
+ * @param options - Options
+ */
+export declare function uploadDataFlowsFromCsv({ auth, trackerStatus, file, classifyService, transcendUrl, }: {
+    /** CSV file path */
+    file: string;
+    /** Transcend API key authentication */
+    auth: string;
+    /** Sombra API key authentication */
+    trackerStatus: ConsentTrackerStatus;
+    /** classify data flow service if missing */
+    classifyService?: boolean;
+    /** API URL for Transcend backend */
+    transcendUrl?: string;
+}): Promise<void>;
+//# sourceMappingURL=uploadDataFlowsFromCsv.d.ts.map

package/build/consent-manager/uploadDataFlowsFromCsv.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"uploadDataFlowsFromCsv.d.ts","sourceRoot":"","sources":["../../src/consent-manager/uploadDataFlowsFromCsv.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,CAAC,MAAM,OAAO,CAAC;AAE3B,OAAO,EACL,oBAAoB,EAErB,MAAM,6BAA6B,CAAC;AAOrC;;GAEG;AACH,eAAO,MAAM,gBAAgB;IAEzB,iDAAiD;;IAEjD,gCAAgC;;;;;;;;IAEhC,mDAAmD;;;IAInD,gDAAgD;;IAEhD,+CAA+C;;IAE/C,8BAA8B;;IAE9B,mCAAmC;;IAEnC,mDAAmD;;;;;qCAKrD,CAAC;AAcH,oBAAoB;AACpB,MAAM,MAAM,gBAAgB,GAAG,CAAC,CAAC,MAAM,CAAC,OAAO,gBAAgB,CAAC,CAAC;AAEjE;;;;GAIG;AACH,wBAAsB,sBAAsB,CAAC,EAC3C,IAAI,EACJ,aAAa,EACb,IAAI,EACJ,eAAuB,EACvB,YAAyC,GAC1C,EAAE;IACD,oBAAoB;IACpB,IAAI,EAAE,MAAM,CAAC;IACb,uCAAuC;IACvC,IAAI,EAAE,MAAM,CAAC;IACb,oCAAoC;IACpC,aAAa,EAAE,oBAAoB,CAAC;IACpC,4CAA4C;IAC5C,eAAe,CAAC,EAAE,OAAO,CAAC;IAC1B,oCAAoC;IACpC,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB,GAAG,OAAO,CAAC,IAAI,CAAC,CA8DhB"}