@medplum/cli 0.9.2

package/README.md

@@ -0,0 +1,95 @@
+# Medplum Command Line Interface
+
+The Medplum CLI (Command Line Interface) is a set of command line tools to quickly deploy Medplum web applications and Medplum bots.
+
+## Installation
+
+Add as a dependency:
+
+```bash
+npm install @medplum/cli
+```
+
+## Usage
+
+Syntax:
+
+```bash
+medplum <command> <args>
+```
+
+At present, there is only one command called `deploy-bot`.  Syntax:
+
+```bash
+medplum deploy-bot <filename> <bot-id>
+```
+
+Example:
+
+```bash
+medplum deploy-bot dist/hello-world.js e54fa800-02ab-41be-8d48-8c027dd85ccc
+```
+
+In practice, consider adding the command to the `"scripts"` section of your package.json:
+
+```json
+  "scripts": {
+    "build": "tsc",
+    "deploy:hello-world": "medplum deploy-bot dist/hello-world.js e54fa800-02ab-41be-8d48-8c0200000000"
+  },
+```
+
+Then, from the command line, run:
+
+```bash
+npm run deploy:hello-world
+```
+
+Authentication requires client credentials in the form of environment variables `MEDPLUM_CLIENT_ID` and `MEDPLUM_CLIENT_SECRET`.  This supports most use cases, including secrets from CI/CD.  `dotenv` is enabled, so you could store them in `.env` file.
+
+## Example
+
+Write your bot.  This can be TypeScript.  It can reference `@medplum/core` and `node-fetch`:
+
+```ts
+import { MedplumClient } from '@medplum/core';
+import { Resource } from '@medplum/fhirtypes';
+
+export async function handler(medplum: MedplumClient, input: Resource): Promise<any> {
+  console.log('Hello world');
+}
+```
+
+Compile with vanilla `tsc` (no build tools required)
+
+```bash
+npx tsc
+```
+
+Or:
+
+```bash
+npm run build
+```
+
+You get sensible plain old JavaScript output:
+
+```javascript
+export async function handler(medplum, input) {
+    console.log('Hello world');
+}
+```
+
+You can then use the Medplum CLI to deploy it.
+
+```bash
+npm run deploy:hello-world
+```
+
+## About Medplum
+
+Medplum is a healthcare platform that helps you quickly develop high-quality compliant applications. Medplum includes a FHIR server, React component library, and developer app.
+
+## License
+
+Apache 2.0. Copyright &copy; Medplum 2022

package/dist/index.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+import { MedplumClient } from '@medplum/core';
+export declare function main(medplum: MedplumClient, argv: string[]): Promise<void>;

package/dist/index.js

@@ -0,0 +1,79 @@
+#!/usr/bin/env node
+"use strict";
+var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
+    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
+    return new (P || (P = Promise))(function (resolve, reject) {
+        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
+        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
+        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
+        step((generator = generator.apply(thisArg, _arguments || [])).next());
+    });
+};
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.main = void 0;
+const core_1 = require("@medplum/core");
+const dotenv_1 = __importDefault(require("dotenv"));
+const fs_1 = require("fs");
+const node_fetch_1 = __importDefault(require("node-fetch"));
+const path_1 = require("path");
+function main(medplum, argv) {
+    return __awaiter(this, void 0, void 0, function* () {
+        dotenv_1.default.config();
+        if (argv.length < 3) {
+            console.log('Usage: medplum <command>');
+            return;
+        }
+        const command = argv[2];
+        if (command === 'deploy-bot') {
+            yield deployBot(medplum, argv);
+        }
+        else {
+            console.log(`Unknown command: ${command}`);
+        }
+    });
+}
+exports.main = main;
+function deployBot(medplum, argv) {
+    return __awaiter(this, void 0, void 0, function* () {
+        if (argv.length < 5) {
+            console.log('Usage: medplum deploy-bot <bot-name> <bot-id>');
+            return;
+        }
+        const botId = argv[4];
+        if (!botId) {
+            console.log('Error: Bot ID is not set');
+            return;
+        }
+        const filePath = (0, path_1.resolve)(process.cwd(), argv[3]);
+        if (!(0, fs_1.existsSync)(filePath)) {
+            console.log('Error: Bot file does not exist: ' + filePath);
+            return;
+        }
+        const bot = yield medplum.readResource('Bot', botId);
+        if (!bot) {
+            console.log('Error: Bot does not exist: ' + botId);
+            return;
+        }
+        console.log(JSON.stringify(bot, null, 2));
+        try {
+            console.log('Update bot code.....');
+            const result = yield medplum.updateResource(Object.assign(Object.assign({}, bot), { code: (0, fs_1.readFileSync)(filePath, 'utf8') }));
+            console.log(JSON.stringify(result, null, 2));
+        }
+        catch (err) {
+            console.log('Patch error: ', err);
+        }
+    });
+}
+if (process.argv[1].includes('medplum') && process.argv[1].includes('cli')) {
+    const medplum = new core_1.MedplumClient({ fetch: node_fetch_1.default });
+    medplum
+        .clientCredentials(process.env['MEDPLUM_CLIENT_ID'], process.env['MEDPLUM_CLIENT_SECRET'])
+        .then(() => {
+        main(medplum, process.argv).catch((err) => console.error('Unhandled error:', err));
+    });
+}
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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","sourcesContent":["#!/usr/bin/env node\nimport { MedplumClient } from '@medplum/core';\nimport { Bot } from '@medplum/fhirtypes';\nimport dotenv from 'dotenv';\nimport { existsSync, readFileSync } from 'fs';\nimport fetch from 'node-fetch';\nimport { resolve } from 'path';\n\nexport async function main(medplum: MedplumClient, argv: string[]): Promise<void> {\n  dotenv.config();\n\n  if (argv.length < 3) {\n    console.log('Usage: medplum <command>');\n    return;\n  }\n\n  const command = argv[2];\n  if (command === 'deploy-bot') {\n    await deployBot(medplum, argv);\n  } else {\n    console.log(`Unknown command: ${command}`);\n  }\n}\n\nasync function deployBot(medplum: MedplumClient, argv: string[]): Promise<void> {\n  if (argv.length < 5) {\n    console.log('Usage: medplum deploy-bot <bot-name> <bot-id>');\n    return;\n  }\n\n  const botId = argv[4];\n  if (!botId) {\n    console.log('Error: Bot ID is not set');\n    return;\n  }\n\n  const filePath = resolve(process.cwd(), argv[3]);\n  if (!existsSync(filePath)) {\n    console.log('Error: Bot file does not exist: ' + filePath);\n    return;\n  }\n\n  const bot = await medplum.readResource<Bot>('Bot', botId);\n  if (!bot) {\n    console.log('Error: Bot does not exist: ' + botId);\n    return;\n  }\n  console.log(JSON.stringify(bot, null, 2));\n\n  try {\n    console.log('Update bot code.....');\n    const result = await medplum.updateResource({\n      ...bot,\n      code: readFileSync(filePath, 'utf8'),\n    });\n    console.log(JSON.stringify(result, null, 2));\n  } catch (err) {\n    console.log('Patch error: ', err);\n  }\n}\n\nif (process.argv[1].includes('medplum') && process.argv[1].includes('cli')) {\n  const medplum = new MedplumClient({ fetch });\n  medplum\n    .clientCredentials(process.env['MEDPLUM_CLIENT_ID'] as string, process.env['MEDPLUM_CLIENT_SECRET'] as string)\n    .then(() => {\n      main(medplum, process.argv).catch((err) => console.error('Unhandled error:', err));\n    });\n}\n"]}

package/package.json

@@ -0,0 +1,45 @@
+{
+  "name": "@medplum/cli",
+  "version": "0.9.2",
+  "description": "Medplum Command Line Interface",
+  "author": "Medplum <hello@medplum.com>",
+  "license": "Apache-2.0",
+  "homepage": "https://www.medplum.com/",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/medplum/medplum.git",
+    "directory": "packages/cli"
+  },
+  "scripts": {
+    "clean": "rimraf dist",
+    "build": "npm run clean && tsc",
+    "test": "jest"
+  },
+  "dependencies": {
+    "@medplum/core": "0.9.2",
+    "dotenv": "16.0.0",
+    "node-fetch": "2.6.7"
+  },
+  "devDependencies": {
+    "@medplum/fhirtypes": "0.9.2",
+    "@medplum/mock": "0.9.2"
+  },
+  "bin": {
+    "medplum": "./dist/index.js"
+  },
+  "keywords": [
+    "medplum",
+    "fhir",
+    "healthcare",
+    "interoperability",
+    "json",
+    "serialization",
+    "hl7",
+    "standards",
+    "clinical",
+    "dstu2",
+    "stu3",
+    "r4",
+    "normative"
+  ]
+}