@story-health/fhirclient
Version:
JavaScript client for Fast Healthcare Interoperability Resources
1,660 lines (1,365 loc) • 229 kB
JavaScript
/******/ (() => { // webpackBootstrap
/******/ var __webpack_modules__ = ({
/***/ "./node_modules/abortcontroller-polyfill/dist/abortcontroller-polyfill-only.js":
/*!*************************************************************************************!*\
!*** ./node_modules/abortcontroller-polyfill/dist/abortcontroller-polyfill-only.js ***!
\*************************************************************************************/
/***/ ((module, exports, __webpack_require__) => {
var __WEBPACK_AMD_DEFINE_FACTORY__, __WEBPACK_AMD_DEFINE_RESULT__;(function (factory) {
true ? !(__WEBPACK_AMD_DEFINE_FACTORY__ = (factory),
__WEBPACK_AMD_DEFINE_RESULT__ = (typeof __WEBPACK_AMD_DEFINE_FACTORY__ === 'function' ?
(__WEBPACK_AMD_DEFINE_FACTORY__.call(exports, __webpack_require__, exports, module)) :
__WEBPACK_AMD_DEFINE_FACTORY__),
__WEBPACK_AMD_DEFINE_RESULT__ !== undefined && (module.exports = __WEBPACK_AMD_DEFINE_RESULT__)) :
0;
}((function () { 'use strict';
function _classCallCheck(instance, Constructor) {
if (!(instance instanceof Constructor)) {
throw new TypeError("Cannot call a class as a function");
}
}
function _defineProperties(target, props) {
for (var i = 0; i < props.length; i++) {
var descriptor = props[i];
descriptor.enumerable = descriptor.enumerable || false;
descriptor.configurable = true;
if ("value" in descriptor) descriptor.writable = true;
Object.defineProperty(target, descriptor.key, descriptor);
}
}
function _createClass(Constructor, protoProps, staticProps) {
if (protoProps) _defineProperties(Constructor.prototype, protoProps);
if (staticProps) _defineProperties(Constructor, staticProps);
return Constructor;
}
function _inherits(subClass, superClass) {
if (typeof superClass !== "function" && superClass !== null) {
throw new TypeError("Super expression must either be null or a function");
}
subClass.prototype = Object.create(superClass && superClass.prototype, {
constructor: {
value: subClass,
writable: true,
configurable: true
}
});
if (superClass) _setPrototypeOf(subClass, superClass);
}
function _getPrototypeOf(o) {
_getPrototypeOf = Object.setPrototypeOf ? Object.getPrototypeOf : function _getPrototypeOf(o) {
return o.__proto__ || Object.getPrototypeOf(o);
};
return _getPrototypeOf(o);
}
function _setPrototypeOf(o, p) {
_setPrototypeOf = Object.setPrototypeOf || function _setPrototypeOf(o, p) {
o.__proto__ = p;
return o;
};
return _setPrototypeOf(o, p);
}
function _isNativeReflectConstruct() {
if (typeof Reflect === "undefined" || !Reflect.construct) return false;
if (Reflect.construct.sham) return false;
if (typeof Proxy === "function") return true;
try {
Boolean.prototype.valueOf.call(Reflect.construct(Boolean, [], function () {}));
return true;
} catch (e) {
return false;
}
}
function _assertThisInitialized(self) {
if (self === void 0) {
throw new ReferenceError("this hasn't been initialised - super() hasn't been called");
}
return self;
}
function _possibleConstructorReturn(self, call) {
if (call && (typeof call === "object" || typeof call === "function")) {
return call;
}
return _assertThisInitialized(self);
}
function _createSuper(Derived) {
var hasNativeReflectConstruct = _isNativeReflectConstruct();
return function _createSuperInternal() {
var Super = _getPrototypeOf(Derived),
result;
if (hasNativeReflectConstruct) {
var NewTarget = _getPrototypeOf(this).constructor;
result = Reflect.construct(Super, arguments, NewTarget);
} else {
result = Super.apply(this, arguments);
}
return _possibleConstructorReturn(this, result);
};
}
function _superPropBase(object, property) {
while (!Object.prototype.hasOwnProperty.call(object, property)) {
object = _getPrototypeOf(object);
if (object === null) break;
}
return object;
}
function _get(target, property, receiver) {
if (typeof Reflect !== "undefined" && Reflect.get) {
_get = Reflect.get;
} else {
_get = function _get(target, property, receiver) {
var base = _superPropBase(target, property);
if (!base) return;
var desc = Object.getOwnPropertyDescriptor(base, property);
if (desc.get) {
return desc.get.call(receiver);
}
return desc.value;
};
}
return _get(target, property, receiver || target);
}
var Emitter = /*#__PURE__*/function () {
function Emitter() {
_classCallCheck(this, Emitter);
Object.defineProperty(this, 'listeners', {
value: {},
writable: true,
configurable: true
});
}
_createClass(Emitter, [{
key: "addEventListener",
value: function addEventListener(type, callback, options) {
if (!(type in this.listeners)) {
this.listeners[type] = [];
}
this.listeners[type].push({
callback: callback,
options: options
});
}
}, {
key: "removeEventListener",
value: function removeEventListener(type, callback) {
if (!(type in this.listeners)) {
return;
}
var stack = this.listeners[type];
for (var i = 0, l = stack.length; i < l; i++) {
if (stack[i].callback === callback) {
stack.splice(i, 1);
return;
}
}
}
}, {
key: "dispatchEvent",
value: function dispatchEvent(event) {
if (!(event.type in this.listeners)) {
return;
}
var stack = this.listeners[event.type];
var stackToCall = stack.slice();
for (var i = 0, l = stackToCall.length; i < l; i++) {
var listener = stackToCall[i];
try {
listener.callback.call(this, event);
} catch (e) {
Promise.resolve().then(function () {
throw e;
});
}
if (listener.options && listener.options.once) {
this.removeEventListener(event.type, listener.callback);
}
}
return !event.defaultPrevented;
}
}]);
return Emitter;
}();
var AbortSignal = /*#__PURE__*/function (_Emitter) {
_inherits(AbortSignal, _Emitter);
var _super = _createSuper(AbortSignal);
function AbortSignal() {
var _this;
_classCallCheck(this, AbortSignal);
_this = _super.call(this); // Some versions of babel does not transpile super() correctly for IE <= 10, if the parent
// constructor has failed to run, then "this.listeners" will still be undefined and then we call
// the parent constructor directly instead as a workaround. For general details, see babel bug:
// https://github.com/babel/babel/issues/3041
// This hack was added as a fix for the issue described here:
// https://github.com/Financial-Times/polyfill-library/pull/59#issuecomment-477558042
if (!_this.listeners) {
Emitter.call(_assertThisInitialized(_this));
} // Compared to assignment, Object.defineProperty makes properties non-enumerable by default and
// we want Object.keys(new AbortController().signal) to be [] for compat with the native impl
Object.defineProperty(_assertThisInitialized(_this), 'aborted', {
value: false,
writable: true,
configurable: true
});
Object.defineProperty(_assertThisInitialized(_this), 'onabort', {
value: null,
writable: true,
configurable: true
});
return _this;
}
_createClass(AbortSignal, [{
key: "toString",
value: function toString() {
return '[object AbortSignal]';
}
}, {
key: "dispatchEvent",
value: function dispatchEvent(event) {
if (event.type === 'abort') {
this.aborted = true;
if (typeof this.onabort === 'function') {
this.onabort.call(this, event);
}
}
_get(_getPrototypeOf(AbortSignal.prototype), "dispatchEvent", this).call(this, event);
}
}]);
return AbortSignal;
}(Emitter);
var AbortController = /*#__PURE__*/function () {
function AbortController() {
_classCallCheck(this, AbortController);
// Compared to assignment, Object.defineProperty makes properties non-enumerable by default and
// we want Object.keys(new AbortController()) to be [] for compat with the native impl
Object.defineProperty(this, 'signal', {
value: new AbortSignal(),
writable: true,
configurable: true
});
}
_createClass(AbortController, [{
key: "abort",
value: function abort() {
var event;
try {
event = new Event('abort');
} catch (e) {
if (typeof document !== 'undefined') {
if (!document.createEvent) {
// For Internet Explorer 8:
event = document.createEventObject();
event.type = 'abort';
} else {
// For Internet Explorer 11:
event = document.createEvent('Event');
event.initEvent('abort', false, false);
}
} else {
// Fallback where document isn't available:
event = {
type: 'abort',
bubbles: false,
cancelable: false
};
}
}
this.signal.dispatchEvent(event);
}
}, {
key: "toString",
value: function toString() {
return '[object AbortController]';
}
}]);
return AbortController;
}();
if (typeof Symbol !== 'undefined' && Symbol.toStringTag) {
// These are necessary to make sure that we get correct output for:
// Object.prototype.toString.call(new AbortController())
AbortController.prototype[Symbol.toStringTag] = 'AbortController';
AbortSignal.prototype[Symbol.toStringTag] = 'AbortSignal';
}
function polyfillNeeded(self) {
if (self.__FORCE_INSTALL_ABORTCONTROLLER_POLYFILL) {
console.log('__FORCE_INSTALL_ABORTCONTROLLER_POLYFILL=true is set, will force install polyfill');
return true;
} // Note that the "unfetch" minimal fetch polyfill defines fetch() without
// defining window.Request, and this polyfill need to work on top of unfetch
// so the below feature detection needs the !self.AbortController part.
// The Request.prototype check is also needed because Safari versions 11.1.2
// up to and including 12.1.x has a window.AbortController present but still
// does NOT correctly implement abortable fetch:
// https://bugs.webkit.org/show_bug.cgi?id=174980#c2
return typeof self.Request === 'function' && !self.Request.prototype.hasOwnProperty('signal') || !self.AbortController;
}
(function (self) {
if (!polyfillNeeded(self)) {
return;
}
self.AbortController = AbortController;
self.AbortSignal = AbortSignal;
})(typeof self !== 'undefined' ? self : __webpack_require__.g);
})));
/***/ }),
/***/ "./node_modules/debug/src/browser.js":
/*!*******************************************!*\
!*** ./node_modules/debug/src/browser.js ***!
\*******************************************/
/***/ ((module, exports, __webpack_require__) => {
"use strict";
/* eslint-env browser */
/**
* This is the web browser implementation of `debug()`.
*/
exports.formatArgs = formatArgs;
exports.save = save;
exports.load = load;
exports.useColors = useColors;
exports.storage = localstorage();
exports.destroy = (() => {
let warned = false;
return () => {
if (!warned) {
warned = true;
console.warn('Instance method `debug.destroy()` is deprecated and no longer does anything. It will be removed in the next major version of `debug`.');
}
};
})();
/**
* Colors.
*/
exports.colors = ['#0000CC', '#0000FF', '#0033CC', '#0033FF', '#0066CC', '#0066FF', '#0099CC', '#0099FF', '#00CC00', '#00CC33', '#00CC66', '#00CC99', '#00CCCC', '#00CCFF', '#3300CC', '#3300FF', '#3333CC', '#3333FF', '#3366CC', '#3366FF', '#3399CC', '#3399FF', '#33CC00', '#33CC33', '#33CC66', '#33CC99', '#33CCCC', '#33CCFF', '#6600CC', '#6600FF', '#6633CC', '#6633FF', '#66CC00', '#66CC33', '#9900CC', '#9900FF', '#9933CC', '#9933FF', '#99CC00', '#99CC33', '#CC0000', '#CC0033', '#CC0066', '#CC0099', '#CC00CC', '#CC00FF', '#CC3300', '#CC3333', '#CC3366', '#CC3399', '#CC33CC', '#CC33FF', '#CC6600', '#CC6633', '#CC9900', '#CC9933', '#CCCC00', '#CCCC33', '#FF0000', '#FF0033', '#FF0066', '#FF0099', '#FF00CC', '#FF00FF', '#FF3300', '#FF3333', '#FF3366', '#FF3399', '#FF33CC', '#FF33FF', '#FF6600', '#FF6633', '#FF9900', '#FF9933', '#FFCC00', '#FFCC33'];
/**
* Currently only WebKit-based Web Inspectors, Firefox >= v31,
* and the Firebug extension (any Firefox version) are known
* to support "%c" CSS customizations.
*
* TODO: add a `localStorage` variable to explicitly enable/disable colors
*/
// eslint-disable-next-line complexity
function useColors() {
// NB: In an Electron preload script, document will be defined but not fully
// initialized. Since we know we're in Chrome, we'll just detect this case
// explicitly
if (typeof window !== 'undefined' && window.process && (window.process.type === 'renderer' || window.process.__nwjs)) {
return true;
} // Internet Explorer and Edge do not support colors.
if (typeof navigator !== 'undefined' && navigator.userAgent && navigator.userAgent.toLowerCase().match(/(edge|trident)\/(\d+)/)) {
return false;
} // Is webkit? http://stackoverflow.com/a/16459606/376773
// document is undefined in react-native: https://github.com/facebook/react-native/pull/1632
return typeof document !== 'undefined' && document.documentElement && document.documentElement.style && document.documentElement.style.WebkitAppearance || // Is firebug? http://stackoverflow.com/a/398120/376773
typeof window !== 'undefined' && window.console && (window.console.firebug || window.console.exception && window.console.table) || // Is firefox >= v31?
// https://developer.mozilla.org/en-US/docs/Tools/Web_Console#Styling_messages
typeof navigator !== 'undefined' && navigator.userAgent && navigator.userAgent.toLowerCase().match(/firefox\/(\d+)/) && parseInt(RegExp.$1, 10) >= 31 || // Double check webkit in userAgent just in case we are in a worker
typeof navigator !== 'undefined' && navigator.userAgent && navigator.userAgent.toLowerCase().match(/applewebkit\/(\d+)/);
}
/**
* Colorize log arguments if enabled.
*
* @api public
*/
function formatArgs(args) {
args[0] = (this.useColors ? '%c' : '') + this.namespace + (this.useColors ? ' %c' : ' ') + args[0] + (this.useColors ? '%c ' : ' ') + '+' + module.exports.humanize(this.diff);
if (!this.useColors) {
return;
}
const c = 'color: ' + this.color;
args.splice(1, 0, c, 'color: inherit'); // The final "%c" is somewhat tricky, because there could be other
// arguments passed either before or after the %c, so we need to
// figure out the correct index to insert the CSS into
let index = 0;
let lastC = 0;
args[0].replace(/%[a-zA-Z%]/g, match => {
if (match === '%%') {
return;
}
index++;
if (match === '%c') {
// We only are interested in the *last* %c
// (the user may have provided their own)
lastC = index;
}
});
args.splice(lastC, 0, c);
}
/**
* Invokes `console.debug()` when available.
* No-op when `console.debug` is not a "function".
* If `console.debug` is not available, falls back
* to `console.log`.
*
* @api public
*/
exports.log = console.debug || console.log || (() => {});
/**
* Save `namespaces`.
*
* @param {String} namespaces
* @api private
*/
function save(namespaces) {
try {
if (namespaces) {
exports.storage.setItem('debug', namespaces);
} else {
exports.storage.removeItem('debug');
}
} catch (error) {// Swallow
// XXX (@Qix-) should we be logging these?
}
}
/**
* Load `namespaces`.
*
* @return {String} returns the previously persisted debug modes
* @api private
*/
function load() {
let r;
try {
r = exports.storage.getItem('debug');
} catch (error) {// Swallow
// XXX (@Qix-) should we be logging these?
} // If debug isn't set in LS, and we're in Electron, try to load $DEBUG
if (!r && typeof process !== 'undefined' && 'env' in process) {
r = process.env.DEBUG;
}
return r;
}
/**
* Localstorage attempts to return the localstorage.
*
* This is necessary because safari throws
* when a user disables cookies/localstorage
* and you attempt to access it.
*
* @return {LocalStorage}
* @api private
*/
function localstorage() {
try {
// TVMLKit (Apple TV JS Runtime) does not have a window object, just localStorage in the global context
// The Browser also has localStorage in the global context.
return localStorage;
} catch (error) {// Swallow
// XXX (@Qix-) should we be logging these?
}
}
module.exports = __webpack_require__(/*! ./common */ "./node_modules/debug/src/common.js")(exports);
const {
formatters
} = module.exports;
/**
* Map %j to `JSON.stringify()`, since no Web Inspectors do that by default.
*/
formatters.j = function (v) {
try {
return JSON.stringify(v);
} catch (error) {
return '[UnexpectedJSONParseError]: ' + error.message;
}
};
/***/ }),
/***/ "./node_modules/debug/src/common.js":
/*!******************************************!*\
!*** ./node_modules/debug/src/common.js ***!
\******************************************/
/***/ ((module, __unused_webpack_exports, __webpack_require__) => {
"use strict";
/**
* This is the common logic for both the Node.js and web browser
* implementations of `debug()`.
*/
function setup(env) {
createDebug.debug = createDebug;
createDebug.default = createDebug;
createDebug.coerce = coerce;
createDebug.disable = disable;
createDebug.enable = enable;
createDebug.enabled = enabled;
createDebug.humanize = __webpack_require__(/*! ms */ "./node_modules/ms/index.js");
createDebug.destroy = destroy;
Object.keys(env).forEach(key => {
createDebug[key] = env[key];
});
/**
* The currently active debug mode names, and names to skip.
*/
createDebug.names = [];
createDebug.skips = [];
/**
* Map of special "%n" handling functions, for the debug "format" argument.
*
* Valid key names are a single, lower or upper-case letter, i.e. "n" and "N".
*/
createDebug.formatters = {};
/**
* Selects a color for a debug namespace
* @param {String} namespace The namespace string for the debug instance to be colored
* @return {Number|String} An ANSI color code for the given namespace
* @api private
*/
function selectColor(namespace) {
let hash = 0;
for (let i = 0; i < namespace.length; i++) {
hash = (hash << 5) - hash + namespace.charCodeAt(i);
hash |= 0; // Convert to 32bit integer
}
return createDebug.colors[Math.abs(hash) % createDebug.colors.length];
}
createDebug.selectColor = selectColor;
/**
* Create a debugger with the given `namespace`.
*
* @param {String} namespace
* @return {Function}
* @api public
*/
function createDebug(namespace) {
let prevTime;
let enableOverride = null;
let namespacesCache;
let enabledCache;
function debug(...args) {
// Disabled?
if (!debug.enabled) {
return;
}
const self = debug; // Set `diff` timestamp
const curr = Number(new Date());
const ms = curr - (prevTime || curr);
self.diff = ms;
self.prev = prevTime;
self.curr = curr;
prevTime = curr;
args[0] = createDebug.coerce(args[0]);
if (typeof args[0] !== 'string') {
// Anything else let's inspect with %O
args.unshift('%O');
} // Apply any `formatters` transformations
let index = 0;
args[0] = args[0].replace(/%([a-zA-Z%])/g, (match, format) => {
// If we encounter an escaped % then don't increase the array index
if (match === '%%') {
return '%';
}
index++;
const formatter = createDebug.formatters[format];
if (typeof formatter === 'function') {
const val = args[index];
match = formatter.call(self, val); // Now we need to remove `args[index]` since it's inlined in the `format`
args.splice(index, 1);
index--;
}
return match;
}); // Apply env-specific formatting (colors, etc.)
createDebug.formatArgs.call(self, args);
const logFn = self.log || createDebug.log;
logFn.apply(self, args);
}
debug.namespace = namespace;
debug.useColors = createDebug.useColors();
debug.color = createDebug.selectColor(namespace);
debug.extend = extend;
debug.destroy = createDebug.destroy; // XXX Temporary. Will be removed in the next major release.
Object.defineProperty(debug, 'enabled', {
enumerable: true,
configurable: false,
get: () => {
if (enableOverride !== null) {
return enableOverride;
}
if (namespacesCache !== createDebug.namespaces) {
namespacesCache = createDebug.namespaces;
enabledCache = createDebug.enabled(namespace);
}
return enabledCache;
},
set: v => {
enableOverride = v;
}
}); // Env-specific initialization logic for debug instances
if (typeof createDebug.init === 'function') {
createDebug.init(debug);
}
return debug;
}
function extend(namespace, delimiter) {
const newDebug = createDebug(this.namespace + (typeof delimiter === 'undefined' ? ':' : delimiter) + namespace);
newDebug.log = this.log;
return newDebug;
}
/**
* Enables a debug mode by namespaces. This can include modes
* separated by a colon and wildcards.
*
* @param {String} namespaces
* @api public
*/
function enable(namespaces) {
createDebug.save(namespaces);
createDebug.namespaces = namespaces;
createDebug.names = [];
createDebug.skips = [];
let i;
const split = (typeof namespaces === 'string' ? namespaces : '').split(/[\s,]+/);
const len = split.length;
for (i = 0; i < len; i++) {
if (!split[i]) {
// ignore empty strings
continue;
}
namespaces = split[i].replace(/\*/g, '.*?');
if (namespaces[0] === '-') {
createDebug.skips.push(new RegExp('^' + namespaces.slice(1) + '$'));
} else {
createDebug.names.push(new RegExp('^' + namespaces + '$'));
}
}
}
/**
* Disable debug output.
*
* @return {String} namespaces
* @api public
*/
function disable() {
const namespaces = [...createDebug.names.map(toNamespace), ...createDebug.skips.map(toNamespace).map(namespace => '-' + namespace)].join(',');
createDebug.enable('');
return namespaces;
}
/**
* Returns true if the given mode name is enabled, false otherwise.
*
* @param {String} name
* @return {Boolean}
* @api public
*/
function enabled(name) {
if (name[name.length - 1] === '*') {
return true;
}
let i;
let len;
for (i = 0, len = createDebug.skips.length; i < len; i++) {
if (createDebug.skips[i].test(name)) {
return false;
}
}
for (i = 0, len = createDebug.names.length; i < len; i++) {
if (createDebug.names[i].test(name)) {
return true;
}
}
return false;
}
/**
* Convert regexp to namespace
*
* @param {RegExp} regxep
* @return {String} namespace
* @api private
*/
function toNamespace(regexp) {
return regexp.toString().substring(2, regexp.toString().length - 2).replace(/\.\*\?$/, '*');
}
/**
* Coerce `val`.
*
* @param {Mixed} val
* @return {Mixed}
* @api private
*/
function coerce(val) {
if (val instanceof Error) {
return val.stack || val.message;
}
return val;
}
/**
* XXX DO NOT USE. This is a temporary stub function.
* XXX It WILL be removed in the next major release.
*/
function destroy() {
console.warn('Instance method `debug.destroy()` is deprecated and no longer does anything. It will be removed in the next major version of `debug`.');
}
createDebug.enable(createDebug.load());
return createDebug;
}
module.exports = setup;
/***/ }),
/***/ "./src/Client.ts":
/*!***********************!*\
!*** ./src/Client.ts ***!
\***********************/
/***/ ((__unused_webpack_module, exports, __webpack_require__) => {
"use strict";
Object.defineProperty(exports, "__esModule", ({
value: true
}));
const lib_1 = __webpack_require__(/*! ./lib */ "./src/lib.ts");
const strings_1 = __webpack_require__(/*! ./strings */ "./src/strings.ts");
const settings_1 = __webpack_require__(/*! ./settings */ "./src/settings.ts"); // $lab:coverage:off$
// @ts-ignore
const {
Response
} = typeof FHIRCLIENT_PURE !== "undefined" ? window : __webpack_require__(/*! cross-fetch */ "./node_modules/cross-fetch/dist/browser-ponyfill.js"); // $lab:coverage:on$
const debug = lib_1.debug.extend("client");
/**
* Adds patient context to requestOptions object to be used with [[Client.request]]
* @param requestOptions Can be a string URL (relative to the serviceUrl), or an
* object which will be passed to fetch()
* @param client Current FHIR client object containing patient context
* @return requestOptions object contextualized to current patient
*/
async function contextualize(requestOptions, client) {
const base = (0, lib_1.absolute)("/", client.state.serverUrl);
async function contextualURL(_url) {
const resourceType = _url.pathname.split("/").pop();
(0, lib_1.assert)(resourceType, `Invalid url "${_url}"`);
(0, lib_1.assert)(settings_1.patientCompartment.indexOf(resourceType) > -1, `Cannot filter "${resourceType}" resources by patient`);
const conformance = await (0, lib_1.fetchConformanceStatement)(client.state.serverUrl);
const searchParam = (0, lib_1.getPatientParam)(conformance, resourceType);
_url.searchParams.set(searchParam, client.patient.id);
return _url.href;
}
if (typeof requestOptions == "string" || requestOptions instanceof URL) {
return {
url: await contextualURL(new URL(requestOptions + "", base))
};
}
requestOptions.url = await contextualURL(new URL(requestOptions.url + "", base));
return requestOptions;
}
/**
* Gets single reference by id. Caches the result.
* @param refId
* @param cache A map to store the resolved refs
* @param client The client instance
* @param [signal] The `AbortSignal` if any
* @returns The resolved reference
* @private
*/
function getRef(refId, cache, client, signal) {
if (!cache[refId]) {
// Note that we set cache[refId] immediately! When the promise is
// settled it will be updated. This is to avoid a ref being fetched
// twice because some of these requests are executed in parallel.
cache[refId] = client.request({
url: refId,
signal
}).then(res => {
cache[refId] = res;
return res;
}, error => {
delete cache[refId];
throw error;
});
}
return Promise.resolve(cache[refId]);
}
/**
* Resolves a reference in the given resource.
* @param obj FHIR Resource
*/
function resolveRef(obj, path, graph, cache, client, signal) {
const node = (0, lib_1.getPath)(obj, path);
if (node) {
const isArray = Array.isArray(node);
return Promise.all((0, lib_1.makeArray)(node).filter(Boolean).map((item, i) => {
const ref = item.reference;
if (ref) {
return getRef(ref, cache, client, signal).then(sub => {
if (graph) {
if (isArray) {
if (path.indexOf("..") > -1) {
(0, lib_1.setPath)(obj, `${path.replace("..", `.${i}.`)}`, sub);
} else {
(0, lib_1.setPath)(obj, `${path}.${i}`, sub);
}
} else {
(0, lib_1.setPath)(obj, path, sub);
}
}
}).catch(ex => {
/* ignore missing references */
if (ex.status !== 404) {
throw ex;
}
});
}
}));
}
}
/**
* Given a resource and a list of ref paths - resolves them all
* @param obj FHIR Resource
* @param fhirOptions The fhir options of the initiating request call
* @param cache A map to store fetched refs
* @param client The client instance
* @private
*/
function resolveRefs(obj, fhirOptions, cache, client, signal) {
// 1. Sanitize paths, remove any invalid ones
let paths = (0, lib_1.makeArray)(fhirOptions.resolveReferences).filter(Boolean) // No false, 0, null, undefined or ""
.map(path => String(path).trim()).filter(Boolean); // No space-only strings
// 2. Remove duplicates
paths = paths.filter((p, i) => {
const index = paths.indexOf(p, i + 1);
if (index > -1) {
debug("Duplicated reference path \"%s\"", p);
return false;
}
return true;
}); // 3. Early exit if no valid paths are found
if (!paths.length) {
return Promise.resolve();
} // 4. Group the paths by depth so that child refs are looked up
// after their parents!
const groups = {};
paths.forEach(path => {
const len = path.split(".").length;
if (!groups[len]) {
groups[len] = [];
}
groups[len].push(path);
}); // 5. Execute groups sequentially! Paths within same group are
// fetched in parallel!
let task = Promise.resolve();
Object.keys(groups).sort().forEach(len => {
const group = groups[len];
task = task.then(() => Promise.all(group.map(path => {
return resolveRef(obj, path, !!fhirOptions.graph, cache, client, signal);
})));
});
return task;
}
/**
* This is a FHIR client that is returned to you from the `ready()` call of the
* **SMART API**. You can also create it yourself if needed:
*
* ```js
* // BROWSER
* const client = FHIR.client("https://r4.smarthealthit.org");
*
* // SERVER
* const client = smart(req, res).client("https://r4.smarthealthit.org");
* ```
*/
class Client {
/**
* Validates the parameters, creates an instance and tries to connect it to
* FhirJS, if one is available globally.
*/
constructor(environment, state) {
/**
* @category Utility
*/
this.units = lib_1.units;
const _state = typeof state == "string" ? {
serverUrl: state
} : state; // Valid serverUrl is required!
(0, lib_1.assert)(_state.serverUrl && _state.serverUrl.match(/https?:\/\/.+/), "A \"serverUrl\" option is required and must begin with \"http(s)\"");
this.state = _state;
this.environment = environment;
this._refreshTask = null;
const client = this; // patient api ---------------------------------------------------------
this.patient = {
get id() {
return client.getPatientId();
},
read: requestOptions => {
const id = this.patient.id;
return id ? this.request({ ...requestOptions,
url: `Patient/${id}`
}) : Promise.reject(new Error("Patient is not available"));
},
request: (requestOptions, fhirOptions = {}) => {
if (this.patient.id) {
return (async () => {
const options = await contextualize(requestOptions, this);
return this.request(options, fhirOptions);
})();
} else {
return Promise.reject(new Error("Patient is not available"));
}
}
}; // encounter api -------------------------------------------------------
this.encounter = {
get id() {
return client.getEncounterId();
},
read: requestOptions => {
const id = this.encounter.id;
return id ? this.request({ ...requestOptions,
url: `Encounter/${id}`
}) : Promise.reject(new Error("Encounter is not available"));
}
}; // user api ------------------------------------------------------------
this.user = {
get fhirUser() {
return client.getFhirUser();
},
get id() {
return client.getUserId();
},
get resourceType() {
return client.getUserType();
},
read: requestOptions => {
const fhirUser = this.user.fhirUser;
return fhirUser ? this.request({ ...requestOptions,
url: fhirUser
}) : Promise.reject(new Error("User is not available"));
}
}; // fhir.js api (attached automatically in browser)
// ---------------------------------------------------------------------
this.connect(environment.fhir);
}
/**
* This method is used to make the "link" between the `fhirclient` and the
* `fhir.js`, if one is available.
* **Note:** This is called by the constructor. If fhir.js is available in
* the global scope as `fhir`, it will automatically be linked to any [[Client]]
* instance. You should only use this method to connect to `fhir.js` which
* is not global.
*/
connect(fhirJs) {
if (typeof fhirJs == "function") {
const options = {
baseUrl: this.state.serverUrl.replace(/\/$/, "")
};
const accessToken = this.getState("tokenResponse.access_token");
if (accessToken) {
options.auth = {
token: accessToken
};
} else {
const {
username,
password
} = this.state;
if (username && password) {
options.auth = {
user: username,
pass: password
};
}
}
this.api = fhirJs(options);
const patientId = this.getState("tokenResponse.patient");
if (patientId) {
this.patient.api = fhirJs({ ...options,
patient: patientId
});
}
}
return this;
}
/**
* Returns the ID of the selected patient or null. You should have requested
* "launch/patient" scope. Otherwise this will return null.
*/
getPatientId() {
const tokenResponse = this.state.tokenResponse;
if (tokenResponse) {
// We have been authorized against this server but we don't know
// the patient. This should be a scope issue.
if (!tokenResponse.patient) {
if (!(this.state.scope || "").match(/\blaunch(\/patient)?\b/)) {
debug(strings_1.default.noScopeForId, "patient", "patient");
} else {
// The server should have returned the patient!
debug("The ID of the selected patient is not available. Please check if your server supports that.");
}
return null;
}
return tokenResponse.patient;
}
if (this.state.authorizeUri) {
debug(strings_1.default.noIfNoAuth, "the ID of the selected patient");
} else {
debug(strings_1.default.noFreeContext, "selected patient");
}
return null;
}
/**
* Returns the ID of the selected encounter or null. You should have
* requested "launch/encounter" scope. Otherwise this will return null.
* Note that not all servers support the "launch/encounter" scope so this
* will be null if they don't.
*/
getEncounterId() {
const tokenResponse = this.state.tokenResponse;
if (tokenResponse) {
// We have been authorized against this server but we don't know
// the encounter. This should be a scope issue.
if (!tokenResponse.encounter) {
if (!(this.state.scope || "").match(/\blaunch(\/encounter)?\b/)) {
debug(strings_1.default.noScopeForId, "encounter", "encounter");
} else {
// The server should have returned the encounter!
debug("The ID of the selected encounter is not available. Please check if your server supports that, and that the selected patient has any recorded encounters.");
}
return null;
}
return tokenResponse.encounter;
}
if (this.state.authorizeUri) {
debug(strings_1.default.noIfNoAuth, "the ID of the selected encounter");
} else {
debug(strings_1.default.noFreeContext, "selected encounter");
}
return null;
}
/**
* Returns the (decoded) id_token if any. You need to request "openid" and
* "profile" scopes if you need to receive an id_token (if you need to know
* who the logged-in user is).
*/
getIdToken() {
const tokenResponse = this.state.tokenResponse;
if (tokenResponse) {
const idToken = tokenResponse.id_token;
const scope = this.state.scope || ""; // We have been authorized against this server but we don't have
// the id_token. This should be a scope issue.
if (!idToken) {
const hasOpenid = scope.match(/\bopenid\b/);
const hasProfile = scope.match(/\bprofile\b/);
const hasFhirUser = scope.match(/\bfhirUser\b/);
if (!hasOpenid || !(hasFhirUser || hasProfile)) {
debug("You are trying to get the id_token but you are not " + "using the right scopes. Please add 'openid' and " + "'fhirUser' or 'profile' to the scopes you are " + "requesting.");
} else {
// The server should have returned the id_token!
debug("The id_token is not available. Please check if your server supports that.");
}
return null;
}
return (0, lib_1.jwtDecode)(idToken, this.environment);
}
if (this.state.authorizeUri) {
debug(strings_1.default.noIfNoAuth, "the id_token");
} else {
debug(strings_1.default.noFreeContext, "id_token");
}
return null;
}
/**
* Returns the profile of the logged_in user (if any). This is a string
* having the following shape `"{user type}/{user id}"`. For example:
* `"Practitioner/abc"` or `"Patient/xyz"`.
*/
getFhirUser() {
const idToken = this.getIdToken();
if (idToken) {
// Epic may return a full url
// @see https://github.com/smart-on-fhir/client-js/issues/105
if (idToken.fhirUser) {
return idToken.fhirUser.split("/").slice(-2).join("/");
}
return idToken.profile;
}
return null;
}
/**
* Returns the user ID or null.
*/
getUserId() {
const profile = this.getFhirUser();
if (profile) {
return profile.split("/")[1];
}
return null;
}
/**
* Returns the type of the logged-in user or null. The result can be
* "Practitioner", "Patient" or "RelatedPerson".
*/
getUserType() {
const profile = this.getFhirUser();
if (profile) {
return profile.split("/")[0];
}
return null;
}
/**
* Builds and returns the value of the `Authorization` header that can be
* sent to the FHIR server
*/
getAuthorizationHeader() {
const accessToken = this.getState("tokenResponse.access_token");
if (accessToken) {
return "Bearer " + accessToken;
}
const {
username,
password
} = this.state;
if (username && password) {
return "Basic " + this.environment.btoa(username + ":" + password);
}
return null;
}
/**
* Used internally to clear the state of the instance and the state in the
* associated storage.
*/
async _clearState() {
const storage = this.environment.getStorage();
const key = await storage.get(settings_1.SMART_KEY);
if (key) {
await storage.unset(key);
}
await storage.unset(settings_1.SMART_KEY);
this.state.tokenResponse = {};
}
/**
* Creates a new resource in a server-assigned location
* @see http://hl7.org/fhir/http.html#create
* @param resource A FHIR resource to be created
* @param [requestOptions] Any options to be passed to the fetch call.
* Note that `method` and `body` will be ignored.
* @category Request
*/
create(resource, requestOptions) {
return this.request({ ...requestOptions,
url: `${resource.resourceType}`,
method: "POST",
body: JSON.stringify(resource),
headers: {
// TODO: Do we need to alternate with "application/json+fhir"?
"content-type": "application/json",
...(requestOptions || {}).headers
}
});
}
/**
* Creates a new current version for an existing resource or creates an
* initial version if no resource already exists for the given id.
* @see http://hl7.org/fhir/http.html#update
* @param resource A FHIR resource to be updated
* @param requestOptions Any options to be passed to the fetch call.
* Note that `method` and `body` will be ignored.
* @category Request
*/
update(resource, requestOptions) {
return this.request({ ...requestOptions,
url: `${resource.resourceType}/${resource.id}`,
method: "PUT",
body: JSON.stringify(resource),
headers: {
// TODO: Do we need to alternate with "application/json+fhir"?
"content-type": "application/json",
...(requestOptions || {}).headers
}
});
}
/**
* Removes an existing resource.
* @see http://hl7.org/fhir/http.html#delete
* @param url Relative URI of the FHIR resource to be deleted
* (format: `resourceType/id`)
* @param requestOptions Any options (except `method` which will be fixed
* to `DELETE`) to be passed to the fetch call.
* @category Request
*/
delete(url, requestOptions = {}) {
return this.request({ ...requestOptions,
url,
method: "DELETE"
});
}
/**
* Makes a JSON Patch to the given resource
* @see http://hl7.org/fhir/http.html#patch
* @param url Relative URI of the FHIR resource to be patched
* (format: `resourceType/id`)
* @param patch A JSON Patch array to send to the server, For details
* see https://datatracker.ietf.org/doc/html/rfc6902
* @param requestOptions Any options to be passed to the fetch call,
* except for `method`, `url` and `body` which cannot be overridden.
* @since 2.4.0
* @category Request
* @typeParam ResolveType This method would typically resolve with the
* patched resource or reject with an OperationOutcome. However, this may
* depend on the server implementation or even on the request headers.
* For that reason, if the default resolve type (which is
* [[fhirclient.FHIR.Resource]]) does not work for you, you can pass
* in your own resolve type parameter.
*/
async patch(url, patch, requestOptions = {}) {
(0, lib_1.assertJsonPatch)(patch);
return this.request({ ...requestOptions,
url,
method: "PATCH",
body: JSON.stringify(patch),
headers: {
"prefer": "return=presentation",
"content-type": "application/json-patch+json; charset=UTF-8",
...requestOptions.headers
}
});
}
/**
* @param requestOptions Can be a string URL (relative to the serviceUrl),
* or an object which will be passed to fetch()
* @param fhirOptions Additional options to control the behavior
* @param _resolvedRefs DO NOT USE! Used internally.
* @category Request
*/
async request(requestOptions, fhirOptions = {}, _resolvedRefs = {}) {
var _a;
const debugRequest = lib_1.debug.extend("client:request");
(0, lib_1.assert)(requestOptions, "request requires an url or request options as argument"); // url -----------------------------------------------------------------
let url;
if (typeof requestOptions == "string" || requestOptions instanceof URL) {
url = String(requestOptions);
requestOptions = {};
} else {
url = String(requestOptions.url);
}
url = (0, lib_1.absolute)(url, this.state.serverUrl);
const options = {
graph: fhirOptions.graph !== false,
flat: !!fhirOptions.flat,
pageLimit: (_a = fhirOptions.pageLimit) !== null && _a !== void 0 ? _a : 1,
resolveReferences: fhirOptions.resolveReferences || [],
useRefreshToken: fhirOptions.useRefreshToken !== false,
onPage: typeof fhirOptions.onPage == "function" ? fhirOptions.onPage : undefined
};
const signal = requestOptions.signal || undefined; // Refresh the access token if needed
const job = options.useRefreshToken ? this.refreshIfNeeded({
signal
}).then(() => requestOptions) : Promise.resolve(requestOptions);
let response;
return job // Add the Authorization header now, after the access token might
// have been updated
.then(requestOptions => {
const authHeader = this.getAuthorizationHeader();
if (authHeader) {
requestOptions.headers = { ...requestOptions.headers,
authorization: authHeader
};
}
return requestOptions;
}) // Make the request
.then(requestOptions => {
debugRequest("%s, options: %O, fhirOptions: %O", url, requestOptions, options);
return (0, lib_1.request)(url, requestOptions).then(result => {
if (requestOptions.includeResponse) {
response = result.response;
return result.body;
}
return result;
});
}) // Handle 401 ------------------------------------------------------
.catch(async error => {
if (error.status == 401) {
// !accessToken -> not authorized -> No session. Need to launch.
if (!this.getState("tokenResponse.access_token")) {
error.message += "\nThis app cannot be accessed directly. Please launch it as SMART app!";
throw error;
} // auto-refresh not enabled and Session expired.
// Need to re-launch. Clear state to start over!
if (!options.useRefreshToken) {
debugRequest("Your session has expired and the useRefreshToken option is set to false. Please re-launch the app.");
await this._clearState();
error.message += "\n" + strings_1.default.expired;
throw error;
} // In rare cases we may have a valid access token and a refresh
// token and the request might still fail with 401 just because
// the access token has just been revoked.
// otherwise -> auto-refresh failed. Session expired.
// Need to re-launch. Clear state to start over!
debugRequest("Auto-refresh failed! Please re-launch the app.");
await this._clearState();
error.message += "\n" + strings_1.default.expired;
throw error;
}
throw error;
}) // Handle 403 ------------------------------------------------------
.catch(error => {
if (error.status == 403) {
debugRequest("Permission denied! Please make sure that you have requested the proper scopes.");
}
throw error;
}).then(data => {
// At this point we don't know what `data` actually is!
// We might gen an empty or falsy result. If so return it as is
if (!data) return data; // Handle raw responses
if (typeof data == "string" || data instanceof Response) return data; // Resolve References ------------------------------------------
return (async _data => {
if (_data.resourceType == "Bundle") {
await Promise.all((_data.entry || []).map(item => resolveRefs(item.resource, options, _resolvedRefs, this, signal)));
} else {
await resolveRefs(_data, options, _resolvedRefs, this, signal);
}
return _data;
})(data) // Pagination ----------------------------------------------
.then(async _data => {
if (_data && _data.resourceType == "Bundle") {
const links = _data.link || [];
if (options.flat) {
_data = (_data.entry || []).map(entry => entry.resource);
}
if (options.onPage) {
await options.onPage(_data, { ..._resolvedRefs
});
}
if (--options.pageLimit) {
const next = links.find(l => l.relation == "next");
_data = (0, lib_1.makeArray)(_data);
if (next && next.url) {
const nextPage = await this.request({
url: next.url,
// Aborting the main request (even after it is complete)
// must propagate to any child requests and abort them!
// To do so, just pass the same AbortSignal if one is
// provided.
signal
}, options, _resolvedRefs);
if (options.onPage) {
return null;
}
if (options.resolveReferences.length) {
Object.assign(_resolvedRefs, nextPage.references);
return _data.concat((0, lib_1.makeArray)(nextPage.data || nextPage));
}
return _data.concat((0, lib_1.makeArray)(nextPage));
}
}
}
return _data;
}) // Finalize ------------------------------------------------
.then(_data => {
if (options.graph) {
_resolvedRefs = {};
} else if (!options.onPage && options.resolveReferences.length) {
return {
data: _data,
references: _resolvedRefs
};
}
return _data;
}).then(_data => {
if (requestOptions.includeResponse) {
return {
body: _data,
response
};
}
return _data;
});
});
}
/**
* Checks if access token and refresh token are present. If they are, and if
* the access token is expired or is about to expire in the next 10 seconds,
* calls `this.refresh()` to obtain new access token.
* @param requestOptions Any options to pass to the fetch call. Most of them
* will be overridden, bit it might still be useful for passing additional
* request options or an abort signal.
* @category Request
*/
refreshIfNeeded(requestOptions = {}) {
const ac