@asushares/cli v2.2.1

ASU SHARES CLI

Command-line utilities aimed at supporting FHIR Consent management and CQL (Clinical Quality Language) operations on FHIR servers. Written and maintained in TypeScript using the Commander library.

Commands

1. convert <filePath> [outputPath]

Converts a .cql file to a base64 encoded string.

• Arguments:

  • <filePath>: Path to the .cql file.
  • [outputPath] (optional): Path to save the base64 encoded output.

• Usage:

  ts-node asushares.ts convert myfile.cql output.txt

  • If outputPath is omitted, it outputs the base64 string to the console.

2. create-fhir-bundle <filePath> <outputPath> <description> [ipUrl]

Creates a FHIR bundle from a .cql file and saves it as a JSON file.

• Arguments:

  • <filePath>: Path to the .cql file.
  • <outputPath>: Path to save the generated FHIR bundle JSON file.
  • <description>: Description of the library.
  • [ipUrl] (optional): Base URL for the FHIR Library (default is http://localhost:8080/fhir/Library/).

• Usage:

  ts-node asushares.ts create-fhir-bundle myfile.cql bundle.json "Description of the CQL library"

3. post-fhir <filePath> <url>

Posts a FHIR bundle JSON file to a specified FHIR server.

• Arguments:

  • <filePath>: Path to the JSON file containing the FHIR bundle.
  • <url>: Base URL of the FHIR server.

• Usage:

  ts-node asushares.ts post-fhir bundle.json http://localhost:8080/fhir

4. create-and-post <filePath> <outputPath> <description> <url>

Creates a FHIR bundle from a .cql file, saves it as a JSON file, and posts it to a specified URL.

• Arguments:

  • <filePath>: Path to the .cql file.
  • <outputPath>: Path to save the generated FHIR bundle JSON file.
  • <description>: Description of the library.
  • <url>: URL of the server to post the FHIR bundle.

• Usage:

  ts-node asushares.ts create-and-post myfile.cql bundle.json "Description of the CQL library" http://localhost:8080/fhir

5. synthea-upload <directory> <url> --dry-run -d

Upload a directory of Synthea-generated FHIR resources to a FHIR URL using Synthea file naming conventions and loading order.

• Arguments:

  • <directory>: Directory with Synthea-generate "fhir" resource files.
  • <url>: URL of the FHIR server to upload the resources to.
  • --dry-run -d: Perform a dry run without uploading any resources.

• Usage:

  ts-node asushares.ts synthea-upload /dir/to/synthea-files http://localhost:8080/fhir 

6. verify-codes <fhirPath> <csvFilePath> --delete

Verifies JSON files for relevant codes based on a provided CSV and deletes irrelevant files if the delete flag is set.

• Arguments:

  • <fhirPath>: Path to the directory containing JSON files.
  • <csvFilePath>: Path to the CSV file containing relevant codes. The following columns are expected, with no empty rows - Index,Code_Type,Code,Description,Category. The code maps code types eg. SNOWMED-CT to the required URL in the backend. A sample csv is present in the assets folder for reference purposes.
  • --delete: URL of the server to post the FHIR bundle. Optional.

• Usage:

  ts-node asushares.ts verify-codes /Users/username/Documents/synthea/output/fhir /Users/username/Documents/synthea/Verification_CSV.csv

Dependencies

• commander: Command-line argument parsing.
• fs: File system operations.
• axios: Making HTTP requests.
• ts-progress: Simple progress bar.
• csv-parser: Used for parsing input csvs.

Attribution

Authors:

• Abhishek Dhadwal
• Preston Lee

Released under the Apache 2.0 license.