@health-samurai/aidbox-client 0.0.0-alpha.1 → 0.0.0-alpha.2

package/README.md

@@ -7,17 +7,10 @@ A typescript client for interacting with a FHIR server.
 The client is created with the `makeClient` function:
 
 ```typescript
-const client = makeClient({ baseurl: "https://fhir-server.address" });
-```
-
-This constructor accepts an additional `onResponse` option, which is a side-effect-only function, that recieves a copy of the Response from the server as is:
-
-```typescript
+const baseUrl = "https://fhir-server.address";
 const client = makeClient({
-  baseurl: "https://fhir-server.address"
-  onResponse: (response: Response) => {
-    /* analyze Response, use throw to interrupt request early */
-  }
+  baseUrl,
+  authProvider: new BrowserAuthProvider(baseUrl);
 });
 ```
 
@@ -65,7 +58,7 @@ if (result.isOk()) {
 }
 
 if (result.isErr()) {
-  const outcome: OperationOutcome = result.error.resource;
+  const outcome: OperationOutcome = result.value.resource;
   // process OperationOutcome
 }
 ```
@@ -114,14 +107,14 @@ Most client methods return a `Result<T, E>` object, with methods to check if the
 ```typescript
 const result = await client.read<Patient>({type: 'Patient', id: 'patient-id'});
 if (result.isErr())
-    throw new Error("error reading Patient", { cause: result.error })
+    throw new Error("error reading Patient", { cause: result.value })
 
 const { resource: patient } = result.value;
 
 // work with patient.
 ```
 
-Unwrapping is not required to modify the data in the result:
+Unwrapping is not required to modify the data in the `Result`:
 
 ```typescript
 const result = await client.read<Patient>({type: 'Patient', id: 'patient-id'});

package/dist/src/auth-providers.d.ts

@@ -0,0 +1,10 @@
+import type { AuthProvider } from "./types";
+export declare class BrowserAuthProvider implements AuthProvider {
+    #private;
+    baseUrl: string;
+    constructor(baseUrl: string);
+    establishSession(): Promise<void>;
+    revokeSession(): Promise<void>;
+    fetch(input: RequestInfo | URL, init?: RequestInit): Promise<Response>;
+}
+//# sourceMappingURL=auth-providers.d.ts.map

package/dist/src/auth-providers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"auth-providers.d.ts","sourceRoot":"","sources":["../../src/auth-providers.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AAE5C,qBAAa,mBAAoB,YAAW,YAAY;;IAChD,OAAO,EAAE,MAAM,CAAC;gBAEX,OAAO,EAAE,MAAM;IAgBd,gBAAgB;IAQhB,aAAa;IAWb,KAAK,CACjB,KAAK,EAAE,WAAW,GAAG,GAAG,EACxB,IAAI,CAAC,EAAE,WAAW,GAChB,OAAO,CAAC,QAAQ,CAAC;CAsBpB"}

package/dist/src/auth-providers.js

@@ -0,0 +1,313 @@
+function asyncGeneratorStep(gen, resolve, reject, _next, _throw, key, arg) {
+    try {
+        var info = gen[key](arg);
+        var value = info.value;
+    } catch (error) {
+        reject(error);
+        return;
+    }
+    if (info.done) {
+        resolve(value);
+    } else {
+        Promise.resolve(value).then(_next, _throw);
+    }
+}
+function _async_to_generator(fn) {
+    return function() {
+        var self = this, args = arguments;
+        return new Promise(function(resolve, reject) {
+            var gen = fn.apply(self, args);
+            function _next(value) {
+                asyncGeneratorStep(gen, resolve, reject, _next, _throw, "next", value);
+            }
+            function _throw(err) {
+                asyncGeneratorStep(gen, resolve, reject, _next, _throw, "throw", err);
+            }
+            _next(undefined);
+        });
+    };
+}
+function _check_private_redeclaration(obj, privateCollection) {
+    if (privateCollection.has(obj)) {
+        throw new TypeError("Cannot initialize the same private elements twice on an object");
+    }
+}
+function _class_call_check(instance, Constructor) {
+    if (!(instance instanceof Constructor)) {
+        throw new TypeError("Cannot call a class as a function");
+    }
+}
+function _class_private_method_get(receiver, privateSet, fn) {
+    if (!privateSet.has(receiver)) {
+        throw new TypeError("attempted to get private field on non-instance");
+    }
+    return fn;
+}
+function _class_private_method_init(obj, privateSet) {
+    _check_private_redeclaration(obj, privateSet);
+    privateSet.add(obj);
+}
+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 _create_class(Constructor, protoProps, staticProps) {
+    if (protoProps) _defineProperties(Constructor.prototype, protoProps);
+    if (staticProps) _defineProperties(Constructor, staticProps);
+    return Constructor;
+}
+function _define_property(obj, key, value) {
+    if (key in obj) {
+        Object.defineProperty(obj, key, {
+            value: value,
+            enumerable: true,
+            configurable: true,
+            writable: true
+        });
+    } else {
+        obj[key] = value;
+    }
+    return obj;
+}
+function _instanceof(left, right) {
+    if (right != null && typeof Symbol !== "undefined" && right[Symbol.hasInstance]) {
+        return !!right[Symbol.hasInstance](left);
+    } else {
+        return left instanceof right;
+    }
+}
+function _ts_generator(thisArg, body) {
+    var f, y, t, _ = {
+        label: 0,
+        sent: function() {
+            if (t[0] & 1) throw t[1];
+            return t[1];
+        },
+        trys: [],
+        ops: []
+    }, g = Object.create((typeof Iterator === "function" ? Iterator : Object).prototype);
+    return g.next = verb(0), g["throw"] = verb(1), g["return"] = verb(2), typeof Symbol === "function" && (g[Symbol.iterator] = function() {
+        return this;
+    }), g;
+    function verb(n) {
+        return function(v) {
+            return step([
+                n,
+                v
+            ]);
+        };
+    }
+    function step(op) {
+        if (f) throw new TypeError("Generator is already executing.");
+        while(g && (g = 0, op[0] && (_ = 0)), _)try {
+            if (f = 1, y && (t = op[0] & 2 ? y["return"] : op[0] ? y["throw"] || ((t = y["return"]) && t.call(y), 0) : y.next) && !(t = t.call(y, op[1])).done) return t;
+            if (y = 0, t) op = [
+                op[0] & 2,
+                t.value
+            ];
+            switch(op[0]){
+                case 0:
+                case 1:
+                    t = op;
+                    break;
+                case 4:
+                    _.label++;
+                    return {
+                        value: op[1],
+                        done: false
+                    };
+                case 5:
+                    _.label++;
+                    y = op[1];
+                    op = [
+                        0
+                    ];
+                    continue;
+                case 7:
+                    op = _.ops.pop();
+                    _.trys.pop();
+                    continue;
+                default:
+                    if (!(t = _.trys, t = t.length > 0 && t[t.length - 1]) && (op[0] === 6 || op[0] === 2)) {
+                        _ = 0;
+                        continue;
+                    }
+                    if (op[0] === 3 && (!t || op[1] > t[0] && op[1] < t[3])) {
+                        _.label = op[1];
+                        break;
+                    }
+                    if (op[0] === 6 && _.label < t[1]) {
+                        _.label = t[1];
+                        t = op;
+                        break;
+                    }
+                    if (t && _.label < t[2]) {
+                        _.label = t[2];
+                        _.ops.push(op);
+                        break;
+                    }
+                    if (t[2]) _.ops.pop();
+                    _.trys.pop();
+                    continue;
+            }
+            op = body.call(thisArg, _);
+        } catch (e) {
+            op = [
+                6,
+                e
+            ];
+            y = 0;
+        } finally{
+            f = t = 0;
+        }
+        if (op[0] & 5) throw op[1];
+        return {
+            value: op[0] ? op[1] : void 0,
+            done: true
+        };
+    }
+}
+var _checkSession = /*#__PURE__*/ new WeakSet();
+export var BrowserAuthProvider = /*#__PURE__*/ function() {
+    "use strict";
+    function BrowserAuthProvider(baseUrl) {
+        _class_call_check(this, BrowserAuthProvider);
+        _class_private_method_init(this, _checkSession);
+        _define_property(this, "baseUrl", void 0);
+        this.baseUrl = baseUrl;
+    }
+    _create_class(BrowserAuthProvider, [
+        {
+            key: "establishSession",
+            value: function establishSession() {
+                return _async_to_generator(function() {
+                    var encodedLocation, redirectTo;
+                    return _ts_generator(this, function(_state) {
+                        switch(_state.label){
+                            case 0:
+                                return [
+                                    4,
+                                    _class_private_method_get(this, _checkSession, checkSession).call(this)
+                                ];
+                            case 1:
+                                if (!_state.sent()) {
+                                    encodedLocation = encodeURIComponent(btoa(window.location.href));
+                                    redirectTo = "".concat(this.baseUrl, "/auth/login?redirect_to=").concat(encodedLocation);
+                                    window.location.href = redirectTo;
+                                }
+                                return [
+                                    2
+                                ];
+                        }
+                    });
+                }).call(this);
+            }
+        },
+        {
+            key: "revokeSession",
+            value: function revokeSession() {
+                return _async_to_generator(function() {
+                    return _ts_generator(this, function(_state) {
+                        switch(_state.label){
+                            case 0:
+                                return [
+                                    4,
+                                    fetch(new URL("/auth/logout", this.baseUrl), {
+                                        method: "POST",
+                                        headers: {
+                                            "content-type": "application/json",
+                                            accept: "application/json"
+                                        },
+                                        credentials: "include"
+                                    })
+                                ];
+                            case 1:
+                                _state.sent();
+                                return [
+                                    2
+                                ];
+                        }
+                    });
+                }).call(this);
+            }
+        },
+        {
+            key: "fetch",
+            value: function fetch1(input, init) {
+                return _async_to_generator(function() {
+                    var url, i, response;
+                    return _ts_generator(this, function(_state) {
+                        switch(_state.label){
+                            case 0:
+                                if (_instanceof(input, Request)) url = input.url;
+                                else url = input.toString();
+                                if (!url.startsWith(this.baseUrl)) throw Error("url of the request must start with baseUrl");
+                                i = init !== null && init !== void 0 ? init : {};
+                                i.credentials = "include";
+                                return [
+                                    4,
+                                    fetch(input, i)
+                                ];
+                            case 1:
+                                response = _state.sent();
+                                if (!(response.status === 401)) return [
+                                    3,
+                                    3
+                                ];
+                                return [
+                                    4,
+                                    this.establishSession()
+                                ];
+                            case 2:
+                                _state.sent();
+                                throw new Error("unauthorized");
+                            case 3:
+                                return [
+                                    2,
+                                    response
+                                ];
+                            case 4:
+                                return [
+                                    2
+                                ];
+                        }
+                    });
+                }).call(this);
+            }
+        }
+    ]);
+    return BrowserAuthProvider;
+} // TODO: backend auth provider
+();
+function checkSession() {
+    return _async_to_generator(function() {
+        var response;
+        return _ts_generator(this, function(_state) {
+            switch(_state.label){
+                case 0:
+                    return [
+                        4,
+                        fetch(new URL("/auth/userinfo", this.baseUrl), {
+                            method: "GET",
+                            headers: {
+                                "content-type": "application/json",
+                                accept: "application/json"
+                            },
+                            credentials: "include"
+                        })
+                    ];
+                case 1:
+                    response = _state.sent();
+                    return [
+                        2,
+                        response.status !== 401
+                    ];
+            }
+        });
+    }).call(this);
+}

package/dist/src/client.d.ts

@@ -1,13 +1,20 @@
-import type { ClientParams, FhirServerClient } from "./types";
+import type { AidboxClient, ClientParams } from "./types";
 /**
  * Create a client to the FHIR server.
  *
  * ```typescript
- * const client = makeClient({ baseurl: "https://fhir-server.address" })
+ * const baseUrl = "https://fhir-server.address";
+ * const client = makeClient({
+ *   baseUrl,
+ *   authProvider: new BrowserAuthProvider(baseUrl);
+ * });
  *
  * // alternatively, specify different FHIR types:
  * import type { Bundle, OperationOutcome } from "hl7-fhir-r5-core";
- * const client = makeClient<Bundle, OperationOutcome>({ baseurl: "https://fhir-server.address" })
+ * const client = makeClient<Bundle, OperationOutcome, User>({
+ *   baseUrl,
+ *   authProvider: new BrowserAuthProvider(baseUrl);
+ * });
  * ```
  *
  * Main client functions are `request` for typed interactions, and `rawRequest` for manual response processing.
@@ -15,11 +22,28 @@ import type { ClientParams, FhirServerClient } from "./types";
  * This client also provides a set of convenience methods for accessing FHIR operations:
  *
  * - `read`
- * - `search`
+ * - `vread`
+ * - `searchType`
+ * - `searchSystem`
+ * - `searchCompartment`
  * - `create`
+ * - `conditionalCreate`
+ * - `update`
+ * - `conditionalUpdate`
+ * - `patch`
+ * - `conditionalPatch`
+ * - `delete: deleteOp`
+ * - `deleteHistory`
+ * - `deleteHistoryVersion`
+ * - `conditionalDelete`
+ * - `historyInstance`
+ * - `historyType`
+ * - `historySystem`
+ * - `capabilities`
+ * - `batch`
+ * - `transaction`
  * - `operation`
  * - `validate`
- *
  */
-export declare function makeClient<TBundle, TOperationOutcome, TUser>({ baseurl, onResponse, }: ClientParams): FhirServerClient<TBundle, TOperationOutcome, TUser>;
+export declare function makeClient<TBundle, TOperationOutcome, TUser>({ baseUrl, authProvider, }: ClientParams): AidboxClient<TBundle, TOperationOutcome, TUser>;
 //# sourceMappingURL=client.d.ts.map

package/dist/src/client.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../../src/client.ts"],"names":[],"mappings":"AAsBA,OAAO,KAAK,EACX,YAAY,EACZ,gBAAgB,EAIhB,MAAM,SAAS,CAAC;AAgBjB;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,wBAAgB,UAAU,CAAC,OAAO,EAAE,iBAAiB,EAAE,KAAK,EAAE,EAC7D,OAAO,EACP,UAAsB,GACtB,EAAE,YAAY,GAAG,gBAAgB,CAAC,OAAO,EAAE,iBAAiB,EAAE,KAAK,CAAC,CA+dpE"}
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../../src/client.ts"],"names":[],"mappings":"AA0BA,OAAO,KAAK,EACX,YAAY,EACZ,YAAY,EAIZ,MAAM,SAAS,CAAC;AAsBjB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6CG;AACH,wBAAgB,UAAU,CAAC,OAAO,EAAE,iBAAiB,EAAE,KAAK,EAAE,EAC7D,OAAO,EACP,YAAY,GACZ,EAAE,YAAY,GAAG,YAAY,CAAC,OAAO,EAAE,iBAAiB,EAAE,KAAK,CAAC,CAihBhE"}