@icanbwell/bwell-sdk-ts 0.1.2 → 0.2.0

package/dist/telemetry/open-telemetry.js

@@ -0,0 +1,87 @@
+var __classPrivateFieldGet = (this && this.__classPrivateFieldGet) || function (receiver, state, kind, f) {
+    if (kind === "a" && !f) throw new TypeError("Private accessor was defined without a getter");
+    if (typeof state === "function" ? receiver !== state || !f : !state.has(receiver)) throw new TypeError("Cannot read private member from an object whose class did not declare it");
+    return kind === "m" ? f : kind === "a" ? f.call(receiver) : f ? f.value : state.get(receiver);
+};
+var __classPrivateFieldSet = (this && this.__classPrivateFieldSet) || function (receiver, state, value, kind, f) {
+    if (kind === "m") throw new TypeError("Private method is not writable");
+    if (kind === "a" && !f) throw new TypeError("Private accessor was defined without a setter");
+    if (typeof state === "function" ? receiver !== state || !f : !state.has(receiver)) throw new TypeError("Cannot write private member to an object whose class did not declare it");
+    return (kind === "a" ? f.call(receiver, value) : f ? f.value = value : state.set(receiver, value)), value;
+};
+var _OpenTelemetry_instances, _OpenTelemetry_resource, _OpenTelemetry_tracerProvider, _OpenTelemetry_loggerProvider, _OpenTelemetry_initializeResource, _OpenTelemetry_initializeTraceProvider, _OpenTelemetry_initializeLoggerProvider, _OpenTelemetry_registerFetchInstrumentation;
+import { W3CTraceContextPropagator } from "@opentelemetry/core";
+import { OTLPLogExporter } from "@opentelemetry/exporter-logs-otlp-http";
+import { Resource } from "@opentelemetry/resources";
+import { BatchLogRecordProcessor, LoggerProvider, } from "@opentelemetry/sdk-logs";
+import { BasicTracerProvider } from "@opentelemetry/sdk-trace-base";
+import { SEMRESATTRS_DEPLOYMENT_ENVIRONMENT, SEMRESATTRS_SERVICE_NAME, SEMRESATTRS_SERVICE_NAMESPACE, SEMRESATTRS_SERVICE_VERSION, SEMRESATTRS_TELEMETRY_SDK_LANGUAGE, } from "@opentelemetry/semantic-conventions";
+import { sdkVersion } from "../utils/index.js";
+import { getRuntimeInstrumentation } from "./open-telemetry-instrumentation.js";
+export class OpenTelemetry {
+    constructor(config) {
+        _OpenTelemetry_instances.add(this);
+        _OpenTelemetry_resource.set(this, void 0);
+        // If the BasicTracerProvider does not work we will probably want to use the
+        // WebTracerProvider and the NodeTracerProvider
+        // @see https://github.com/open-telemetry/opentelemetry-js/tree/main/packages/opentelemetry-sdk-trace-node
+        // @see https://www.npmjs.com/package/@opentelemetry/sdk-trace-web
+        _OpenTelemetry_tracerProvider.set(this, void 0);
+        _OpenTelemetry_loggerProvider.set(this, void 0);
+        __classPrivateFieldSet(this, _OpenTelemetry_resource, __classPrivateFieldGet(this, _OpenTelemetry_instances, "m", _OpenTelemetry_initializeResource).call(this, config), "f");
+        __classPrivateFieldSet(this, _OpenTelemetry_tracerProvider, __classPrivateFieldGet(this, _OpenTelemetry_instances, "m", _OpenTelemetry_initializeTraceProvider).call(this), "f");
+        __classPrivateFieldSet(this, _OpenTelemetry_loggerProvider, __classPrivateFieldGet(this, _OpenTelemetry_instances, "m", _OpenTelemetry_initializeLoggerProvider).call(this, config), "f");
+        this.fetchInstrumentation = __classPrivateFieldGet(this, _OpenTelemetry_instances, "m", _OpenTelemetry_registerFetchInstrumentation).call(this);
+    }
+    loggerProvider() {
+        return __classPrivateFieldGet(this, _OpenTelemetry_loggerProvider, "f");
+    }
+    resource() {
+        return __classPrivateFieldGet(this, _OpenTelemetry_resource, "f");
+    }
+    // public tracerProvider(): WebTracerProvider {
+    tracerProvider() {
+        return __classPrivateFieldGet(this, _OpenTelemetry_tracerProvider, "f");
+    }
+}
+_OpenTelemetry_resource = new WeakMap(), _OpenTelemetry_tracerProvider = new WeakMap(), _OpenTelemetry_loggerProvider = new WeakMap(), _OpenTelemetry_instances = new WeakSet(), _OpenTelemetry_initializeResource = function _OpenTelemetry_initializeResource(config) {
+    var _a, _b, _c, _d;
+    return Resource.default().merge(new Resource({
+        [SEMRESATTRS_SERVICE_NAME]: "bwell-sdk-typescript",
+        [SEMRESATTRS_SERVICE_VERSION]: sdkVersion(),
+        [SEMRESATTRS_TELEMETRY_SDK_LANGUAGE]: "typescript",
+        [SEMRESATTRS_SERVICE_NAMESPACE]: "com.bwell",
+        [SEMRESATTRS_DEPLOYMENT_ENVIRONMENT]: config.context.env,
+        "client.key": config.context.clientKey,
+        "user.id": (_b = (_a = config.context.user) === null || _a === void 0 ? void 0 : _a.clientFhirPersonId) !== null && _b !== void 0 ? _b : "",
+        "user.bwell-person-id": (_d = (_c = config.context.user) === null || _c === void 0 ? void 0 : _c.bwellFhirPersonId) !== null && _d !== void 0 ? _d : "",
+    }));
+}, _OpenTelemetry_initializeTraceProvider = function _OpenTelemetry_initializeTraceProvider() {
+    // TODO: Research using the AlwaysOffSampler
+    // @see https://github.com/open-telemetry/opentelemetry-js/tree/main/packages/opentelemetry-sdk-trace-base#alwaysoff-sampler
+    const tracerProvider = new BasicTracerProvider({
+        resource: __classPrivateFieldGet(this, _OpenTelemetry_resource, "f"),
+    });
+    tracerProvider.register({
+        propagator: new W3CTraceContextPropagator(),
+    });
+    return tracerProvider;
+}, _OpenTelemetry_initializeLoggerProvider = function _OpenTelemetry_initializeLoggerProvider(config) {
+    const loggerProvider = new LoggerProvider({
+        resource: __classPrivateFieldGet(this, _OpenTelemetry_resource, "f"),
+    });
+    const exporter = new OTLPLogExporter({
+        url: `${config.telemetry.collectorUrl}/otlp-http/v1/logs`,
+    });
+    const processor = new BatchLogRecordProcessor(exporter);
+    loggerProvider.addLogRecordProcessor(processor);
+    return loggerProvider;
+}, _OpenTelemetry_registerFetchInstrumentation = function _OpenTelemetry_registerFetchInstrumentation() {
+    const fetchInstrumentation = getRuntimeInstrumentation();
+    if (fetchInstrumentation === null) {
+        return null;
+    }
+    fetchInstrumentation.setTracerProvider(__classPrivateFieldGet(this, _OpenTelemetry_tracerProvider, "f"));
+    return fetchInstrumentation;
+};
+//# sourceMappingURL=open-telemetry.js.map

package/dist/telemetry/open-telemetry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"open-telemetry.js","sourceRoot":"","sources":["../../src/telemetry/open-telemetry.ts"],"names":[],"mappings":"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"}

package/dist/telemetry/telemetry.d.ts

@@ -0,0 +1,8 @@
+import { TracerProvider } from "@opentelemetry/api";
+import type * as logsAPI from "@opentelemetry/api-logs";
+import { Resource } from "@opentelemetry/resources";
+export interface Telemetry {
+    resource(): Resource;
+    tracerProvider(): TracerProvider;
+    loggerProvider(): logsAPI.LoggerProvider;
+}

package/dist/telemetry/telemetry.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=telemetry.js.map

package/dist/telemetry/telemetry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"telemetry.js","sourceRoot":"","sources":["../../src/telemetry/telemetry.ts"],"names":[],"mappings":""}

package/dist/tokens/index.d.ts

@@ -0,0 +1,2 @@
+export * from "./jwt-token-manager.js";
+export * from "./token-storage.js";

package/dist/tokens/index.js

@@ -0,0 +1,3 @@
+export * from "./jwt-token-manager.js";
+export * from "./token-storage.js";
+//# sourceMappingURL=index.js.map

package/dist/tokens/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/tokens/index.ts"],"names":[],"mappings":"AAAA,cAAc,wBAAwB,CAAC;AACvC,cAAc,oBAAoB,CAAC"}

package/dist/tokens/jwt-token-manager.d.ts

@@ -0,0 +1,32 @@
+import { IdentityManager } from "../api/base/identity/index.js";
+import { InvalidTokenError, OperationOutcomeError } from "../errors/index.js";
+import { LoggerProvider } from "../logger/index.js";
+import { BWellTransactionResult } from "../results/index.js";
+import { TokenStorage } from "./token-storage.js";
+export type TokenManagerConfig = {
+    accessToken: string;
+    idToken: string;
+    clientKey: string;
+    refreshToken: string;
+};
+export interface TokenManager {
+    getAccessToken(): Promise<BWellTransactionResult<string, OperationOutcomeError | InvalidTokenError>>;
+    getIdToken(): Promise<string | undefined>;
+}
+export declare class JWTTokenManager implements TokenManager {
+    #private;
+    private constructor();
+    /**
+     * Instantiates a new JWTTokenManager after parsing and validating the provided
+     * accessToken.
+     *
+     * This static method publicly takes the place of new JWTTokenManager() for
+     * the purposes of returning a BWellTransactionResult with potential failures
+     * since you shouldn't return anything from the constructor other than a JWTTokenManager
+     *
+     * @returns {BWellTransactionResult<JWTTokenManager, InvalidTokenError>}
+     */
+    static initialize(config: TokenManagerConfig, identManager: IdentityManager, loggerProvider?: LoggerProvider, tokenStorage?: TokenStorage): Promise<BWellTransactionResult<JWTTokenManager, InvalidTokenError>>;
+    getAccessToken(): Promise<BWellTransactionResult<string, OperationOutcomeError | InvalidTokenError>>;
+    getIdToken(): Promise<string | undefined>;
+}

package/dist/tokens/jwt-token-manager.js

@@ -0,0 +1,150 @@
+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 __classPrivateFieldSet = (this && this.__classPrivateFieldSet) || function (receiver, state, value, kind, f) {
+    if (kind === "m") throw new TypeError("Private method is not writable");
+    if (kind === "a" && !f) throw new TypeError("Private accessor was defined without a setter");
+    if (typeof state === "function" ? receiver !== state || !f : !state.has(receiver)) throw new TypeError("Cannot write private member to an object whose class did not declare it");
+    return (kind === "a" ? f.call(receiver, value) : f ? f.value = value : state.set(receiver, value)), value;
+};
+var __classPrivateFieldGet = (this && this.__classPrivateFieldGet) || function (receiver, state, kind, f) {
+    if (kind === "a" && !f) throw new TypeError("Private accessor was defined without a getter");
+    if (typeof state === "function" ? receiver !== state || !f : !state.has(receiver)) throw new TypeError("Cannot read private member from an object whose class did not declare it");
+    return kind === "m" ? f : kind === "a" ? f.call(receiver) : f ? f.value : state.get(receiver);
+};
+var _JWTTokenManager_instances, _a, _JWTTokenManager_identityManager, _JWTTokenManager_logger, _JWTTokenManager_tokenStorage, _JWTTokenManager_parseTokenExpiration, _JWTTokenManager_getExpiration, _JWTTokenManager_isAccessTokenExpired, _JWTTokenManager_refreshAccessToken;
+import { BWellError, InvalidTokenError, } from "../errors/index.js";
+import { ConsoleLoggerProvider, } from "../logger/index.js";
+import { BWellTransactionResult } from "../results/index.js";
+import { isUndefined, parseTokenExpiration } from "../utils/index.js";
+import { InMemoryTokenStorage } from "./token-storage.js";
+export class JWTTokenManager {
+    constructor(config, identManager, loggerProvider, tokenStorage) {
+        _JWTTokenManager_instances.add(this);
+        _JWTTokenManager_identityManager.set(this, void 0);
+        _JWTTokenManager_logger.set(this, void 0);
+        _JWTTokenManager_tokenStorage.set(this, void 0);
+        __classPrivateFieldSet(this, _JWTTokenManager_identityManager, identManager, "f");
+        __classPrivateFieldSet(this, _JWTTokenManager_logger, loggerProvider.getLogger("TokenManager"), "f");
+        __classPrivateFieldSet(this, _JWTTokenManager_tokenStorage, tokenStorage, "f");
+    }
+    /**
+     * Instantiates a new JWTTokenManager after parsing and validating the provided
+     * accessToken.
+     *
+     * This static method publicly takes the place of new JWTTokenManager() for
+     * the purposes of returning a BWellTransactionResult with potential failures
+     * since you shouldn't return anything from the constructor other than a JWTTokenManager
+     *
+     * @returns {BWellTransactionResult<JWTTokenManager, InvalidTokenError>}
+     */
+    static initialize(config_1, identManager_1) {
+        return __awaiter(this, arguments, void 0, function* (config, identManager, loggerProvider = new ConsoleLoggerProvider(), tokenStorage = new InMemoryTokenStorage()) {
+            const expirationResult = __classPrivateFieldGet(_a, _a, "m", _JWTTokenManager_parseTokenExpiration).call(_a, config.accessToken);
+            if (expirationResult.failure()) {
+                return expirationResult.intoFailure();
+            }
+            const tokenManager = new _a(Object.assign(Object.assign({}, config), { expiration: expirationResult.data() }), identManager, loggerProvider, tokenStorage);
+            try {
+                yield Promise.all([
+                    tokenStorage.set("idToken", config.idToken),
+                    tokenStorage.set("clientKey", config.clientKey),
+                    tokenStorage.set("accessToken", config.accessToken),
+                    tokenStorage.set("refreshToken", config.refreshToken),
+                    tokenStorage.set("expiration", expirationResult.data().toISOString()),
+                ]);
+            }
+            catch (e) {
+                return BWellTransactionResult.failure(new InvalidTokenError("Failed to set tokens in token storage"));
+            }
+            return BWellTransactionResult.success(tokenManager);
+        });
+    }
+    getAccessToken() {
+        return __awaiter(this, void 0, void 0, function* () {
+            const tokenIsExpired = yield __classPrivateFieldGet(this, _JWTTokenManager_instances, "m", _JWTTokenManager_isAccessTokenExpired).call(this);
+            if (tokenIsExpired) {
+                const refreshResults = yield __classPrivateFieldGet(this, _JWTTokenManager_instances, "m", _JWTTokenManager_refreshAccessToken).call(this);
+                if (refreshResults.failure()) {
+                    return refreshResults.intoFailure();
+                }
+            }
+            const accessToken = yield __classPrivateFieldGet(this, _JWTTokenManager_tokenStorage, "f").get("accessToken");
+            if (isUndefined(accessToken)) {
+                return BWellTransactionResult.failure(new InvalidTokenError("accessToken not found in token storage"));
+            }
+            return BWellTransactionResult.success(accessToken);
+        });
+    }
+    getIdToken() {
+        return __awaiter(this, void 0, void 0, function* () {
+            return yield __classPrivateFieldGet(this, _JWTTokenManager_tokenStorage, "f").get("idToken");
+        });
+    }
+}
+_a = JWTTokenManager, _JWTTokenManager_identityManager = new WeakMap(), _JWTTokenManager_logger = new WeakMap(), _JWTTokenManager_tokenStorage = new WeakMap(), _JWTTokenManager_instances = new WeakSet(), _JWTTokenManager_parseTokenExpiration = function _JWTTokenManager_parseTokenExpiration(accessToken) {
+    try {
+        const parsedExpirationTime = parseTokenExpiration(accessToken);
+        return BWellTransactionResult.success(new Date(parsedExpirationTime));
+    }
+    catch (e) {
+        // If an error that we don't expect is caught, log it and re-throw it
+        // Its quite difficult to trigger an error that is not a BWellError in tests
+        // so we cannot test the case where an unexpected error is caught.
+        /* istanbul ignore next */
+        if (!BWellError.isBwellError(e)) {
+            throw e;
+        }
+        return BWellTransactionResult.failure(e);
+    }
+}, _JWTTokenManager_getExpiration = function _JWTTokenManager_getExpiration() {
+    return __awaiter(this, void 0, void 0, function* () {
+        const expirationString = yield __classPrivateFieldGet(this, _JWTTokenManager_tokenStorage, "f").get("expiration");
+        if (isUndefined(expirationString)) {
+            throw new Error("expiration not found in token storage");
+        }
+        return new Date(expirationString);
+    });
+}, _JWTTokenManager_isAccessTokenExpired = function _JWTTokenManager_isAccessTokenExpired() {
+    return __awaiter(this, void 0, void 0, function* () {
+        const expirationDate = yield __classPrivateFieldGet(this, _JWTTokenManager_instances, "m", _JWTTokenManager_getExpiration).call(this);
+        const expirationTime = expirationDate.getTime();
+        const now = Date.now();
+        return expirationTime < now;
+    });
+}, _JWTTokenManager_refreshAccessToken = function _JWTTokenManager_refreshAccessToken() {
+    return __awaiter(this, void 0, void 0, function* () {
+        __classPrivateFieldGet(this, _JWTTokenManager_logger, "f").verbose("refreshing access token...");
+        const [refreshToken, clientKey] = yield Promise.all([
+            __classPrivateFieldGet(this, _JWTTokenManager_tokenStorage, "f").get("refreshToken"),
+            __classPrivateFieldGet(this, _JWTTokenManager_tokenStorage, "f").get("clientKey"),
+        ]);
+        if (isUndefined(refreshToken) || isUndefined(clientKey)) {
+            return BWellTransactionResult.failure(new InvalidTokenError("refreshToken or clientKey not found in token storage"));
+        }
+        const results = yield __classPrivateFieldGet(this, _JWTTokenManager_identityManager, "f").refreshAccessToken({
+            refreshToken: refreshToken,
+            clientKey: clientKey,
+        });
+        __classPrivateFieldGet(this, _JWTTokenManager_logger, "f").verbose("refreshing access token complete");
+        if (results.failure()) {
+            return results.intoFailure();
+        }
+        const refreshAccessTokenData = results.data();
+        yield __classPrivateFieldGet(this, _JWTTokenManager_tokenStorage, "f").set("accessToken", refreshAccessTokenData.accessToken);
+        yield __classPrivateFieldGet(this, _JWTTokenManager_tokenStorage, "f").set("idToken", refreshAccessTokenData.idToken);
+        const parseExpirationResult = __classPrivateFieldGet(_a, _a, "m", _JWTTokenManager_parseTokenExpiration).call(_a, refreshAccessTokenData.accessToken);
+        if (parseExpirationResult.failure()) {
+            return parseExpirationResult.intoFailure();
+        }
+        yield __classPrivateFieldGet(this, _JWTTokenManager_tokenStorage, "f").set("expiration", parseExpirationResult.data().toISOString());
+        return BWellTransactionResult.success(null);
+    });
+};
+//# sourceMappingURL=jwt-token-manager.js.map

package/dist/tokens/jwt-token-manager.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"jwt-token-manager.js","sourceRoot":"","sources":["../../src/tokens/jwt-token-manager.ts"],"names":[],"mappings":"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"}

package/dist/tokens/token-storage.d.ts

@@ -0,0 +1,33 @@
+/**
+ * Interface for storing tokens.
+ * We might want to store more than one kind of token, so the interface is for a key-value store.
+ * All methods are asynchronous, in cases of storage in the cloud, over the network, in a multi-step process, etc.
+ */
+export interface TokenStorage {
+    /**
+     * Get the value for a key.
+     * @param key The key to look up the value.
+     */
+    get(key: string): Promise<string | undefined>;
+    /**
+     * Set the value for a key.
+     * @param key The key to set the value.
+     * @param value The value to set.
+     */
+    set(key: string, value: string): Promise<void>;
+    /**
+     * Delete the value for a key.
+     * @param key The key to delete the value.
+     */
+    delete(key: string): Promise<boolean>;
+}
+/**
+ * Default token storage implementation that stores tokens in memory.
+ */
+export declare class InMemoryTokenStorage {
+    private storage;
+    constructor(storage?: Map<string, string>);
+    get(key: string): Promise<string | undefined>;
+    set(key: string, value: string): Promise<void>;
+    delete(key: string): Promise<boolean>;
+}

package/dist/tokens/token-storage.js

@@ -0,0 +1,33 @@
+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());
+    });
+};
+/**
+ * Default token storage implementation that stores tokens in memory.
+ */
+export class InMemoryTokenStorage {
+    constructor(storage = new Map()) {
+        this.storage = storage;
+    }
+    get(key) {
+        return __awaiter(this, void 0, void 0, function* () {
+            return this.storage.get(key);
+        });
+    }
+    set(key, value) {
+        return __awaiter(this, void 0, void 0, function* () {
+            this.storage.set(key, value);
+        });
+    }
+    delete(key) {
+        return __awaiter(this, void 0, void 0, function* () {
+            return this.storage.delete(key);
+        });
+    }
+}
+//# sourceMappingURL=token-storage.js.map

package/dist/tokens/token-storage.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"token-storage.js","sourceRoot":"","sources":["../../src/tokens/token-storage.ts"],"names":[],"mappings":";;;;;;;;;AAwBA;;GAEG;AACH,MAAM,OAAO,oBAAoB;IAC/B,YACU,UAA+B,IAAI,GAAG,EAAkB;QAAxD,YAAO,GAAP,OAAO,CAAiD;IAC/D,CAAC;IAEE,GAAG,CAAC,GAAW;;YACnB,OAAO,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;QAC/B,CAAC;KAAA;IAEK,GAAG,CAAC,GAAW,EAAE,KAAa;;YAClC,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC;QAC/B,CAAC;KAAA;IAEK,MAAM,CAAC,GAAW;;YACtB,OAAO,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;QAClC,CAAC;KAAA;CACF"}

package/dist/utils/base64.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Decodes a Base64 encoded string to a utf-8 encoded string.
+ *
+ * Node.js and Browser runtimes have different API's for decoding Base64 encoded
+ * strings so a runtime check is necessary.
+ *
+ * atob and btoa are deprecated in Node.js so we need to use Buffer.from
+ * @see https://nodejs.org/api/buffer.html#bufferatobdata
+ *
+ * The Buffer API is not available in browswer runtimes, so using atob is required
+ */
+export declare function base64Decode(base64String: string): string;

package/dist/utils/base64.js

@@ -0,0 +1,22 @@
+import { getRuntime } from "./runtime.js";
+/**
+ * Decodes a Base64 encoded string to a utf-8 encoded string.
+ *
+ * Node.js and Browser runtimes have different API's for decoding Base64 encoded
+ * strings so a runtime check is necessary.
+ *
+ * atob and btoa are deprecated in Node.js so we need to use Buffer.from
+ * @see https://nodejs.org/api/buffer.html#bufferatobdata
+ *
+ * The Buffer API is not available in browswer runtimes, so using atob is required
+ */
+export function base64Decode(base64String) {
+    switch (getRuntime()) {
+        case "node":
+            return Buffer.from(base64String, "base64").toString("utf-8");
+        case "browser":
+            // @see https://developer.mozilla.org/en-US/docs/Web/API/atob
+            return atob(base64String);
+    }
+}
+//# sourceMappingURL=base64.js.map

package/dist/utils/base64.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"base64.js","sourceRoot":"","sources":["../../src/utils/base64.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAE1C;;;;;;;;;;GAUG;AACH,MAAM,UAAU,YAAY,CAAC,YAAoB;IAC/C,QAAQ,UAAU,EAAE,EAAE,CAAC;QACrB,KAAK,MAAM;YACT,OAAO,MAAM,CAAC,IAAI,CAAC,YAAY,EAAE,QAAQ,CAAC,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC;QAE/D,KAAK,SAAS;YACZ,6DAA6D;YAC7D,OAAO,IAAI,CAAC,YAAY,CAAC,CAAC;IAC9B,CAAC;AACH,CAAC"}

package/dist/utils/index.d.ts

@@ -0,0 +1,6 @@
+export * from "./base64.js";
+export * from "./parsing-utils.js";
+export * from "./runtime.js";
+export * from "./string-utils.js";
+export * from "./type-utils.js";
+export * from "./version.js";

package/dist/utils/index.js

@@ -0,0 +1,7 @@
+export * from "./base64.js";
+export * from "./parsing-utils.js";
+export * from "./runtime.js";
+export * from "./string-utils.js";
+export * from "./type-utils.js";
+export * from "./version.js";
+//# sourceMappingURL=index.js.map

package/dist/utils/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/utils/index.ts"],"names":[],"mappings":"AAAA,cAAc,aAAa,CAAC;AAC5B,cAAc,oBAAoB,CAAC;AACnC,cAAc,cAAc,CAAC;AAC7B,cAAc,mBAAmB,CAAC;AAClC,cAAc,iBAAiB,CAAC;AAChC,cAAc,cAAc,CAAC"}

package/dist/utils/parsing-utils.d.ts

@@ -0,0 +1,26 @@
+import type { User } from "../models/index.js";
+export declare function retrieveEnvironmentFromClientKey(clientKey: string): string;
+/**
+ * Returns the JSON parsed payload section of a JWT
+ *
+ * @param {string} token - token to parse
+ * @returns {T} parsed data
+ * @throws {InvalidTokenError} - If token is corrupt or cannot be JSON parsed
+ */
+export declare function parseJWTPayload<T>(token: string): T;
+/**
+ * Parses a JWT and gets the expiration from the JWT payload.
+ *
+ * @param {string} token - JWT to parse
+ * @returns {number} Expiration date expressed in milliseconds
+ * @throws {InvalidTokenError} if token is invalid base64, JWT, JSON paylaod or expiration
+ */
+export declare function parseTokenExpiration(token: string): number;
+/**
+ * Parses a JWT and pulls BWell user data from the payload.
+ *
+ * @param {string} token - JWT to parse
+ * @returns {User} pulled from the JWT payload
+ * @throws {InvalidTokenError} if token is invalid base64, JWT or JSON paylaod
+ */
+export declare function parseUserFromIdToken(token: string): User;

package/dist/utils/parsing-utils.js

@@ -0,0 +1,69 @@
+import { InvalidTokenError } from "../errors/index.js";
+import { base64Decode } from "./base64.js";
+import { isNotNullOrUndefined } from "./type-utils.js";
+export function retrieveEnvironmentFromClientKey(clientKey) {
+    const decodeClientKeyJson = JSON.parse(base64Decode(clientKey));
+    return decodeClientKeyJson["env"];
+}
+const JWT_PART_SIZE = 3;
+/**
+ * Returns the JSON parsed payload section of a JWT
+ *
+ * @param {string} token - token to parse
+ * @returns {T} parsed data
+ * @throws {InvalidTokenError} - If token is corrupt or cannot be JSON parsed
+ */
+export function parseJWTPayload(token) {
+    const splitToken = token.split(".");
+    const tokenPayload = splitToken[1];
+    if (tokenPayload === undefined || splitToken.length !== JWT_PART_SIZE) {
+        throw new InvalidTokenError("Token is missing data and may be corrupted");
+    }
+    try {
+        const tokenJson = JSON.parse(base64Decode(tokenPayload));
+        return tokenJson;
+    }
+    catch (err) {
+        const cause = err;
+        throw new InvalidTokenError(`Unable to parse token payload: ${cause.name} - ${cause.message}`);
+    }
+}
+/**
+ * Parses a JWT and gets the expiration from the JWT payload.
+ *
+ * @param {string} token - JWT to parse
+ * @returns {number} Expiration date expressed in milliseconds
+ * @throws {InvalidTokenError} if token is invalid base64, JWT, JSON paylaod or expiration
+ */
+export function parseTokenExpiration(token) {
+    const tokenJson = parseJWTPayload(token);
+    // Parse out the seconds till expiration and convert them to milliseconds.
+    const expiration = tokenJson.exp;
+    if (typeof expiration !== "number") {
+        throw new InvalidTokenError("The access token is missing an expiration date and is most likely corrupted.");
+    }
+    return expiration * 1000;
+}
+const CLIENT_PERSON_ID_KEY = "custom:clientFhirPersonId";
+const BWELL_FHIR_PERSON_ID_KEY = "custom:bwellFhirPatientId";
+/**
+ * Parses a JWT and pulls BWell user data from the payload.
+ *
+ * @param {string} token - JWT to parse
+ * @returns {User} pulled from the JWT payload
+ * @throws {InvalidTokenError} if token is invalid base64, JWT or JSON paylaod
+ */
+export function parseUserFromIdToken(token) {
+    const idTokenJson = parseJWTPayload(token);
+    const bwellFhirPersonId = idTokenJson[BWELL_FHIR_PERSON_ID_KEY];
+    const clientFhirPersonId = idTokenJson[CLIENT_PERSON_ID_KEY];
+    if (isNotNullOrUndefined(bwellFhirPersonId) &&
+        isNotNullOrUndefined(clientFhirPersonId)) {
+        return {
+            bwellFhirPersonId,
+            clientFhirPersonId,
+        };
+    }
+    throw new InvalidTokenError("The idToken does not contain a bwellFhirPerson and/or a clientFhirPersonId");
+}
+//# sourceMappingURL=parsing-utils.js.map

package/dist/utils/parsing-utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"parsing-utils.js","sourceRoot":"","sources":["../../src/utils/parsing-utils.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAC;AAEvD,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAC3C,OAAO,EAAE,oBAAoB,EAAE,MAAM,iBAAiB,CAAC;AAEvD,MAAM,UAAU,gCAAgC,CAAC,SAAiB;IAChE,MAAM,mBAAmB,GAAG,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,SAAS,CAAC,CAAC,CAAC;IAChE,OAAO,mBAAmB,CAAC,KAAK,CAAW,CAAC;AAC9C,CAAC;AAED,MAAM,aAAa,GAAG,CAAC,CAAC;AAMxB;;;;;;GAMG;AACH,MAAM,UAAU,eAAe,CAAI,KAAa;IAC9C,MAAM,UAAU,GAAG,KAAK,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;IAEpC,MAAM,YAAY,GAAG,UAAU,CAAC,CAAC,CAAC,CAAC;IAEnC,IAAI,YAAY,KAAK,SAAS,IAAI,UAAU,CAAC,MAAM,KAAK,aAAa,EAAE,CAAC;QACtE,MAAM,IAAI,iBAAiB,CAAC,4CAA4C,CAAC,CAAC;IAC5E,CAAC;IAED,IAAI,CAAC;QACH,MAAM,SAAS,GAAG,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,YAAY,CAAC,CAAC,CAAC;QAEzD,OAAO,SAAc,CAAC;IACxB,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,MAAM,KAAK,GAAG,GAAY,CAAC;QAE3B,MAAM,IAAI,iBAAiB,CACzB,kCAAkC,KAAK,CAAC,IAAI,MAAM,KAAK,CAAC,OAAO,EAAE,CAClE,CAAC;IACJ,CAAC;AACH,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,oBAAoB,CAAC,KAAa;IAChD,MAAM,SAAS,GAAG,eAAe,CAAsB,KAAK,CAAC,CAAC;IAE9D,0EAA0E;IAC1E,MAAM,UAAU,GAAG,SAAS,CAAC,GAAG,CAAC;IACjC,IAAI,OAAO,UAAU,KAAK,QAAQ,EAAE,CAAC;QACnC,MAAM,IAAI,iBAAiB,CACzB,8EAA8E,CAC/E,CAAC;IACJ,CAAC;IACD,OAAO,UAAU,GAAG,IAAI,CAAC;AAC3B,CAAC;AAED,MAAM,oBAAoB,GAAG,2BAA2B,CAAC;AACzD,MAAM,wBAAwB,GAAG,2BAA2B,CAAC;AAO7D;;;;;;GAMG;AACH,MAAM,UAAU,oBAAoB,CAAC,KAAa;IAChD,MAAM,WAAW,GAAG,eAAe,CAAc,KAAK,CAAC,CAAC;IAExD,MAAM,iBAAiB,GAAG,WAAW,CAAC,wBAAwB,CAAC,CAAC;IAChE,MAAM,kBAAkB,GAAG,WAAW,CAAC,oBAAoB,CAAC,CAAC;IAE7D,IACE,oBAAoB,CAAC,iBAAiB,CAAC;QACvC,oBAAoB,CAAC,kBAAkB,CAAC,EACxC,CAAC;QACD,OAAO;YACL,iBAAiB;YACjB,kBAAkB;SACnB,CAAC;IACJ,CAAC;IAED,MAAM,IAAI,iBAAiB,CACzB,4EAA4E,CAC7E,CAAC;AACJ,CAAC"}

package/dist/utils/runtime.d.ts

@@ -0,0 +1,10 @@
+export type Runtime = "browser" | "node";
+/**
+ * Determines which JavaScript runtime the SDK is being used in.
+ */
+export declare function getRuntime(): Runtime;
+export interface RuntimeExecutor<T> {
+    node(): T;
+    browser(): T;
+}
+export declare function executeForRuntime<T>(runtimeExecutor: RuntimeExecutor<T>): T;

package/dist/utils/runtime.js

@@ -0,0 +1,50 @@
+/**
+ * @see https://nodejs.org/api/process.html#processversions
+ */
+function isNode() {
+    var _a;
+    // Even when testing in a JSDom environment, the process variable still exists
+    // so its dificult to purely test this branch
+    /* istanbul ignore next */
+    const nodeProcessIsAbsent = 
+    // process isn't a native global variable in browsers
+    typeof process === "undefined" ||
+        // Sometimes webpack or other build systems will inject process as a global
+        // so lets check that .versions.node does not exist.
+        ((_a = process.versions) === null || _a === void 0 ? void 0 : _a.node) === undefined;
+    return !nodeProcessIsAbsent;
+}
+function isBrowser() {
+    return typeof window !== "undefined";
+}
+/**
+ * Determines which JavaScript runtime the SDK is being used in.
+ */
+export function getRuntime() {
+    /**
+     *  Need to ensure that the browser runtime check is ran first since running tests
+     *  in jest jsdom environment is still technically in a node environment.
+     *  When tests are ran in jsdom environment, isBrowser will return true, but
+     *  so will isNode whereas when tests are ran in a node jest environment, isBrowser
+     *  will return false.
+     */
+    if (isBrowser()) {
+        return "browser";
+    }
+    if (isNode()) {
+        return "node";
+    }
+    // This is not very testable as we don't have a jest environment that is not
+    // browser-like or node-like available to us.
+    /* istanbul ignore next */
+    throw new Error("Invalid runtime");
+}
+export function executeForRuntime(runtimeExecutor) {
+    switch (getRuntime()) {
+        case "browser":
+            return runtimeExecutor.browser();
+        case "node":
+            return runtimeExecutor.node();
+    }
+}
+//# sourceMappingURL=runtime.js.map

package/dist/utils/runtime.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"runtime.js","sourceRoot":"","sources":["../../src/utils/runtime.ts"],"names":[],"mappings":"AAEA;;GAEG;AACH,SAAS,MAAM;;IACb,8EAA8E;IAC9E,6CAA6C;IAC7C,0BAA0B;IAC1B,MAAM,mBAAmB;IACvB,qDAAqD;IACrD,OAAO,OAAO,KAAK,WAAW;QAC9B,2EAA2E;QAC3E,oDAAoD;QACpD,CAAA,MAAA,OAAO,CAAC,QAAQ,0CAAE,IAAI,MAAK,SAAS,CAAC;IAEvC,OAAO,CAAC,mBAAmB,CAAC;AAC9B,CAAC;AAED,SAAS,SAAS;IAChB,OAAO,OAAO,MAAM,KAAK,WAAW,CAAC;AACvC,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,UAAU;IACxB;;;;;;OAMG;IACH,IAAI,SAAS,EAAE,EAAE,CAAC;QAChB,OAAO,SAAS,CAAC;IACnB,CAAC;IAED,IAAI,MAAM,EAAE,EAAE,CAAC;QACb,OAAO,MAAM,CAAC;IAChB,CAAC;IAED,4EAA4E;IAC5E,6CAA6C;IAC7C,0BAA0B;IAC1B,MAAM,IAAI,KAAK,CAAC,iBAAiB,CAAC,CAAC;AACrC,CAAC;AAOD,MAAM,UAAU,iBAAiB,CAAI,eAAmC;IACtE,QAAQ,UAAU,EAAE,EAAE,CAAC;QACrB,KAAK,SAAS;YACZ,OAAO,eAAe,CAAC,OAAO,EAAE,CAAC;QAEnC,KAAK,MAAM;YACT,OAAO,eAAe,CAAC,IAAI,EAAE,CAAC;IAClC,CAAC;AACH,CAAC"}

package/dist/utils/string-utils.d.ts

@@ -0,0 +1,6 @@
+/**
+ * A utility method for determining if a string is blank.
+ * @param str The string to examine.
+ * @returns true if the string is blank (i.e. "" or "  ").
+ */
+export declare function isBlank(str: string): boolean;