lamp-core-lst 2025.11.1-3.basic

package/.github/workflows/publish.yml

@@ -0,0 +1,34 @@
+name: Publish
+on:
+  release:
+    types: [created]
+jobs:
+  build:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v2
+      - uses: actions/setup-node@v1
+        with:
+          node-version: 16.x
+      - run: |
+          npm install
+      - run: npm test
+  publish-npm:
+    needs: build
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v2
+      - uses: actions/setup-node@v1
+        with:
+          node-version: 16.x
+          registry-url: https://registry.npmjs.org/
+      - name: Autoincrement version
+        run: |
+          # from refs/tags/v1.2.3 get 1.2.3
+          VERSION=$(echo $GITHUB_REF | sed 's#.*/##')
+          npm version --no-git-tag-version $VERSION
+        shell: bash
+      - run: npm install
+      - run: npm publish
+        env:
+          NODE_AUTH_TOKEN: ${{secrets.NPM_AUTH_TOKEN}}

package/LICENSE.md

@@ -0,0 +1,29 @@
+BSD 3-Clause License
+
+Copyright (c) 2020, Division of Digital Psychiatry at Beth Israel Deaconess Medical Center
+All rights reserved.
+
+Redistribution and use in source and binary forms, with or without
+modification, are permitted provided that the following conditions are met:
+
+1. Redistributions of source code must retain the above copyright notice, this
+   list of conditions and the following disclaimer.
+
+2. Redistributions in binary form must reproduce the above copyright notice,
+   this list of conditions and the following disclaimer in the documentation
+   and/or other materials provided with the distribution.
+
+3. Neither the name of the copyright holder nor the names of its
+   contributors may be used to endorse or promote products derived from
+   this software without specific prior written permission.
+
+THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
+AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
+IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
+DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE
+FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
+DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR
+SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER
+CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY,
+OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
+OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.

package/MANUAL.md

@@ -0,0 +1,26 @@
+lamp(3) -- connect to and manipulate objects in the LAMP Platform
+===
+
+## SYNOPSIS
+
+`lamp <type> <method> [<id>]`
+
+## DESCRIPTION
+
+lamp(3) implements a connector and object manipulator to the LAMP Platform. You must specify a `server_address` (defaults to `api.lamp.digital`), `access_key`, and `secret_key`.
+
+## EXAMPLES
+
+None yet. 
+
+## DIAGNOSTICS 
+
+None.
+
+## AUTHOR
+
+Division of Digital Psychiatry at BIDMC <team@digitalpsych.org>
+
+## SEE ALSO 
+
+[Visit our documentation for more information about the LAMP Platform.](https://docs.lamp.digital/)

package/README.md

@@ -0,0 +1,126 @@
+# JavaScript & TypeScript API client for the LAMP Platform
+
+## Overview
+This API client is used to connect to the LAMP Platform from the JavaScript and TypeScript programming languages. [Visit our documentation for more information about the LAMP Platform.](https://docs.lamp.digital/)
+
+## Installation
+
+### Prerequisites
+
+Install the package directly from the GitHub repository.
+
+```sh
+npm i lamp-core
+```
+
+### Configuration
+
+Ensure your `serverAddress` is set correctly. If using the default server, it will be `api.lamp.digital`. Keep your `accessKey` (sometimes an email address) and `secretKey` (sometimes a password) private and do not share them with others.
+
+To make requests using `http`, enable dev mode before attempting to connect to a server. 
+
+**Warning:** Dev mode should only be used for local development!
+
+```javascript
+import LAMP from 'lamp-core'
+LAMP.enableDevMode()    // optional
+await LAMP.connect({ serverAddress: '...', accessKey: '...', secretKey: '...' })
+```
+
+## API Endpoints
+
+All URIs are relative to the `serverAddress` (by default, `api.lamp.digital`).
+
+The protocol defaults to `https` but `http` can be used with dev mode enabled.
+
+Class | Method | HTTP request | Description
+------------ | ------------- | ------------- | -------------
+*LAMP.API* | [**query**](docs/APIApi.md#query) | **POST** / | Query the LAMP Database.
+*LAMP.API* | [**schema**](docs/APIApi.md#schema) | **GET** / | View the API schema document.
+*LAMP.Activity* | [**all**](docs/ActivityApi.md#all) | **GET** /activity | Get the set of all activities.
+*LAMP.Activity* | [**allByParticipant**](docs/ActivityApi.md#allByParticipant) | **GET** /participant/{participant_id}/activity | Get all activities for a participant.
+*LAMP.Activity* | [**allByResearcher**](docs/ActivityApi.md#allByResearcher) | **GET** /researcher/{researcher_id}/activity | Get all activities for a researcher.
+*LAMP.Activity* | [**allByStudy**](docs/ActivityApi.md#allByStudy) | **GET** /study/{study_id}/activity | Get all activities in a study.
+*LAMP.Activity* | [**create**](docs/ActivityApi.md#create) | **POST** /study/{study_id}/activity | Create a new Activity under the given Study.
+*LAMP.Activity* | [**delete**](docs/ActivityApi.md#delete) | **DELETE** /activity/{activity_id} | Delete an Activity.
+*LAMP.Activity* | [**update**](docs/ActivityApi.md#update) | **PUT** /activity/{activity_id} | Update an Activity's settings.
+*LAMP.Activity* | [**view**](docs/ActivityApi.md#view) | **GET** /activity/{activity_id} | Get a single activity, by identifier.
+*LAMP.ActivityEvent* | [**allByParticipant**](docs/ActivityEventApi.md#allByParticipant) | **GET** /participant/{participant_id}/activity_event | Get all activity events for a participant.
+*LAMP.ActivityEvent* | [**allByResearcher**](docs/ActivityEventApi.md#allByResearcher) | **GET** /researcher/{researcher_id}/activity_event | Get all activity events for a researcher by participant.
+*LAMP.ActivityEvent* | [**allByStudy**](docs/ActivityEventApi.md#allByStudy) | **GET** /study/{study_id}/activity_event | Get all activity events for a study by participant.
+*LAMP.ActivityEvent* | [**create**](docs/ActivityEventApi.md#create) | **POST** /participant/{participant_id}/activity_event | Create a new ActivityEvent for the given Participant.
+*LAMP.ActivityEvent* | [**delete**](docs/ActivityEventApi.md#delete) | **DELETE** /participant/{participant_id}/activity_event | Delete a ActivityEvent.
+*LAMP.ActivitySpec* | [**all**](docs/ActivitySpecApi.md#all) | **GET** /activity_spec | Get all ActivitySpecs registered.
+*LAMP.ActivitySpec* | [**create**](docs/ActivitySpecApi.md#create) | **POST** /activity_spec | Create a new ActivitySpec.
+*LAMP.ActivitySpec* | [**delete**](docs/ActivitySpecApi.md#delete) | **DELETE** /activity_spec/{activity_spec_name} | Delete an ActivitySpec.
+*LAMP.ActivitySpec* | [**update**](docs/ActivitySpecApi.md#update) | **PUT** /activity_spec/{activity_spec_name} | Update an ActivitySpec.
+*LAMP.ActivitySpec* | [**view**](docs/ActivitySpecApi.md#view) | **GET** /activity_spec/{activity_spec_name} | View an ActivitySpec.
+*LAMP.Credential* | [**create**](docs/CredentialApi.md#create) | **POST** /type/{type_id}/credential | 
+*LAMP.Credential* | [**delete**](docs/CredentialApi.md#delete) | **DELETE** /type/{type_id}/credential/{access_key} | 
+*LAMP.Credential* | [**list**](docs/CredentialApi.md#list) | **GET** /type/{type_id}/credential | 
+*LAMP.Credential* | [**update**](docs/CredentialApi.md#update) | **PUT** /type/{type_id}/credential/{access_key} | 
+*LAMP.Participant* | [**all**](docs/ParticipantApi.md#all) | **GET** /participant | Get the set of all participants.
+*LAMP.Participant* | [**allByResearcher**](docs/ParticipantApi.md#allByResearcher) | **GET** /researcher/{researcher_id}/participant | Get the set of all participants under a single researcher.
+*LAMP.Participant* | [**allByStudy**](docs/ParticipantApi.md#allByStudy) | **GET** /study/{study_id}/participant | Get the set of all participants in a single study.
+*LAMP.Participant* | [**create**](docs/ParticipantApi.md#create) | **POST** /study/{study_id}/participant | Create a new Participant for the given Study.
+*LAMP.Participant* | [**delete**](docs/ParticipantApi.md#delete) | **DELETE** /participant/{participant_id} | Delete a participant AND all owned data or event streams.
+*LAMP.Participant* | [**update**](docs/ParticipantApi.md#update) | **PUT** /participant/{participant_id} | Update a Participant's settings.
+*LAMP.Participant* | [**view**](docs/ParticipantApi.md#view) | **GET** /participant/{participant_id} | Get a single participant, by identifier.
+*LAMP.Researcher* | [**all**](docs/ResearcherApi.md#all) | **GET** /researcher | Get the set of all researchers.
+*LAMP.Researcher* | [**create**](docs/ResearcherApi.md#create) | **POST** /researcher | Create a new Researcher.
+*LAMP.Researcher* | [**delete**](docs/ResearcherApi.md#delete) | **DELETE** /researcher/{researcher_id} | Delete a researcher.
+*LAMP.Researcher* | [**update**](docs/ResearcherApi.md#update) | **PUT** /researcher/{researcher_id} | Update a Researcher's settings.
+*LAMP.Researcher* | [**view**](docs/ResearcherApi.md#view) | **GET** /researcher/{researcher_id} | Get a single researcher, by identifier.
+*LAMP.Sensor* | [**all**](docs/SensorApi.md#all) | **GET** /sensor | Get the set of all sensors.
+*LAMP.Sensor* | [**allByParticipant**](docs/SensorApi.md#allByParticipant) | **GET** /participant/{participant_id}/sensor | Get all sensors for a participant.
+*LAMP.Sensor* | [**allByResearcher**](docs/SensorApi.md#allByResearcher) | **GET** /researcher/{researcher_id}/sensor | Get all sensors for a researcher.
+*LAMP.Sensor* | [**allByStudy**](docs/SensorApi.md#allByStudy) | **GET** /study/{study_id}/sensor | View all sensors in a study.
+*LAMP.Sensor* | [**create**](docs/SensorApi.md#create) | **POST** /study/{study_id}/sensor | Create a new Sensor under the given Study.
+*LAMP.Sensor* | [**delete**](docs/SensorApi.md#delete) | **DELETE** /sensor/{sensor_id} | Delete a Sensor.
+*LAMP.Sensor* | [**update**](docs/SensorApi.md#update) | **PUT** /sensor/{sensor_id} | Update an Sensor's settings.
+*LAMP.Sensor* | [**view**](docs/SensorApi.md#view) | **GET** /sensor/{sensor_id} | Get a single sensor, by identifier.
+*LAMP.SensorEvent* | [**allByParticipant**](docs/SensorEventApi.md#allByParticipant) | **GET** /participant/{participant_id}/sensor_event | Get all sensor events for a participant.
+*LAMP.SensorEvent* | [**allByResearcher**](docs/SensorEventApi.md#allByResearcher) | **GET** /researcher/{researcher_id}/sensor_event | Get all sensor events for a researcher by participant.
+*LAMP.SensorEvent* | [**allByStudy**](docs/SensorEventApi.md#allByStudy) | **GET** /study/{study_id}/sensor_event | Get all sensor events for a study by participant.
+*LAMP.SensorEvent* | [**create**](docs/SensorEventApi.md#create) | **POST** /participant/{participant_id}/sensor_event | Create a new SensorEvent for the given Participant.
+*LAMP.SensorEvent* | [**delete**](docs/SensorEventApi.md#delete) | **DELETE** /participant/{participant_id}/sensor_event | Delete a sensor event.
+*LAMP.SensorSpec* | [**all**](docs/SensorSpecApi.md#all) | **GET** /sensor_spec | Get all SensorSpecs registered.
+*LAMP.SensorSpec* | [**create**](docs/SensorSpecApi.md#create) | **POST** /sensor_spec | Create a new SensorSpec.
+*LAMP.SensorSpec* | [**delete**](docs/SensorSpecApi.md#delete) | **DELETE** /sensor_spec/{sensor_spec_name} | Delete an SensorSpec.
+*LAMP.SensorSpec* | [**update**](docs/SensorSpecApi.md#update) | **PUT** /sensor_spec/{sensor_spec_name} | Update an SensorSpec.
+*LAMP.SensorSpec* | [**view**](docs/SensorSpecApi.md#view) | **GET** /sensor_spec/{sensor_spec_name} | Get a SensorSpec.
+*LAMP.Study* | [**all**](docs/StudyApi.md#all) | **GET** /study | Get the set of all studies.
+*LAMP.Study* | [**allByResearcher**](docs/StudyApi.md#allByResearcher) | **GET** /researcher/{researcher_id}/study | Get the set of studies for a single researcher.
+*LAMP.Study* | [**create**](docs/StudyApi.md#create) | **POST** /researcher/{researcher_id}/study | Create a new Study for the given Researcher.
+*LAMP.Study* | [**delete**](docs/StudyApi.md#delete) | **DELETE** /study/{study_id} | Delete a study.
+*LAMP.Study* | [**update**](docs/StudyApi.md#update) | **PUT** /study/{study_id} | Update the study.
+*LAMP.Study* | [**view**](docs/StudyApi.md#view) | **GET** /study/{study_id} | Get a single study, by identifier.
+*LAMP.Type* | [**getAttachment**](docs/TypeApi.md#getAttachment) | **GET** /type/{type_id}/attachment/{attachment_key} | 
+*LAMP.Type* | [**getDynamicAttachment**](docs/TypeApi.md#getDynamicAttachment) | **GET** /type/{type_id}/attachment/dynamic/{attachment_key} | 
+*LAMP.Type* | [**listAttachments**](docs/TypeApi.md#listAttachments) | **GET** /type/{type_id}/attachment | 
+*LAMP.Type* | [**parent**](docs/TypeApi.md#parent) | **GET** /type/{type_id}/parent | Find the owner(s) of the resource.
+*LAMP.Type* | [**setAttachment**](docs/TypeApi.md#setAttachment) | **PUT** /type/{type_id}/attachment/{attachment_key}/{target} | 
+*LAMP.Type* | [**setDynamicAttachment**](docs/TypeApi.md#setDynamicAttachment) | **PUT** /type/{type_id}/attachment/dynamic/{attachment_key}/{target} | 
+
+
+## Documentation for Models
+
+ - [AccessCitation](docs/AccessCitation.md)
+ - [Activity](docs/Activity.md)
+ - [ActivityEvent](docs/ActivityEvent.md)
+ - [ActivitySpec](docs/ActivitySpec.md)
+ - [Credential](docs/Credential.md)
+ - [Document](docs/Document.md)
+ - [DurationInterval](docs/DurationInterval.md)
+ - [DurationIntervalLegacy](docs/DurationIntervalLegacy.md)
+ - [DynamicAttachment](docs/DynamicAttachment.md)
+ - [Error](docs/Error.md)
+ - [Metadata](docs/Metadata.md)
+ - [Participant](docs/Participant.md)
+ - [Researcher](docs/Researcher.md)
+ - [Sensor](docs/Sensor.md)
+ - [SensorEvent](docs/SensorEvent.md)
+ - [SensorSpec](docs/SensorSpec.md)
+ - [Study](docs/Study.md)
+ - [TemporalSlice](docs/TemporalSlice.md)
+

package/cli.js

@@ -0,0 +1,2 @@
+#!/usr/bin/env node
+require('.').main()

package/dist/index.d.ts

@@ -0,0 +1,64 @@
+import "isomorphic-fetch";
+import { Researcher, Participant } from "./model/index";
+import { APIService, ActivityService, ActivityEventService, ActivitySpecService, CredentialService, ParticipantService, ResearcherService, SensorService, SensorEventService, SensorSpecService, StudyService, TypeService, ResearcherSettingsService } from "./service/index";
+export * from "./service/index";
+export * from "./model/index";
+/**
+ *
+ */
+interface IAuth {
+    id: string | null;
+    password: string | null;
+    serverAddress: string | undefined;
+    token?: string | undefined;
+}
+/**
+ * The root type in LAMP. You must use `LAMP.connect(...)` to begin using any LAMP classes.
+ */
+export default class LAMP {
+    static API: APIService;
+    static Type: TypeService;
+    static Credential: CredentialService;
+    static Researcher: ResearcherService;
+    static Participant: ParticipantService;
+    static Study: StudyService;
+    static Activity: ActivityService;
+    static ActivityEvent: ActivityEventService;
+    static ActivitySpec: ActivitySpecService;
+    static Sensor: SensorService;
+    static SensorEvent: SensorEventService;
+    static SensorSpec: SensorSpecService;
+    static ResearcherSettings: ResearcherSettingsService;
+    private static get configuration();
+    private static set configuration(value);
+    private static protocol;
+    static enableDevMode(): void;
+    static addEventListener(event: string, callback: (any: any) => void): void;
+    static removeEventListener(event: string, callback: (any: any) => void): void;
+    static dispatchEvent(event: string, detail?: any): void;
+    static initializeDemoDB(db: {
+        [key: string]: any;
+    }): void;
+    static connect(identity?: {
+        accessKey: string | null;
+        secretKey: string | null;
+        serverAddress: string | undefined;
+    }): Promise<void>;
+    static Auth: {
+        new (): {};
+        _auth: IAuth;
+        _me: Researcher[] | Researcher | Participant | null | undefined;
+        _type: "admin" | "researcher" | "participant" | null;
+        /**
+         * Authenticate/authorize as a user of a given `type`.
+         * If all values are null (especially `type`), the authorization is cleared.
+         */
+        set_identity(identity?: {
+            id: string | null;
+            password: string | null;
+            serverAddress: string | null;
+        }): Promise<void>;
+        refresh_identity(): Promise<void>;
+    };
+}
+export declare const main: () => void;

package/dist/index.js

@@ -0,0 +1,311 @@
+"use strict";
+var __assign = (this && this.__assign) || function () {
+    __assign = Object.assign || function(t) {
+        for (var s, i = 1, n = arguments.length; i < n; i++) {
+            s = arguments[i];
+            for (var p in s) if (Object.prototype.hasOwnProperty.call(s, p))
+                t[p] = s[p];
+        }
+        return t;
+    };
+    return __assign.apply(this, arguments);
+};
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    Object.defineProperty(o, k2, { enumerable: true, get: function() { return m[k]; } });
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !exports.hasOwnProperty(p)) __createBinding(exports, m, p);
+};
+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 __generator = (this && this.__generator) || function (thisArg, body) {
+    var _ = { label: 0, sent: function() { if (t[0] & 1) throw t[1]; return t[1]; }, trys: [], ops: [] }, f, y, t, g;
+    return g = { next: verb(0), "throw": verb(1), "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 (_) 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 _a;
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.main = void 0;
+require("isomorphic-fetch");
+var index_1 = require("./service/index");
+var Demo_1 = require("./service/Demo");
+__exportStar(require("./service/index"), exports);
+__exportStar(require("./model/index"), exports);
+//
+var _bus = (_a = global.document) === null || _a === void 0 ? void 0 : _a.createElement("_lamp_fake");
+/**
+ * The root type in LAMP. You must use `LAMP.connect(...)` to begin using any LAMP classes.
+ */
+var LAMP = /** @class */ (function () {
+    function LAMP() {
+    }
+    Object.defineProperty(LAMP, "configuration", {
+        get: function () {
+            return LAMP.API.configuration;
+        },
+        set: function (configuration) {
+            LAMP.API.configuration = configuration;
+            LAMP.Activity.configuration = configuration;
+            LAMP.ActivityEvent.configuration = configuration;
+            LAMP.ActivitySpec.configuration = configuration;
+            LAMP.Credential.configuration = configuration;
+            LAMP.Participant.configuration = configuration;
+            LAMP.Researcher.configuration = configuration;
+            LAMP.Sensor.configuration = configuration;
+            LAMP.SensorEvent.configuration = configuration;
+            LAMP.SensorSpec.configuration = configuration;
+            LAMP.Study.configuration = configuration;
+            LAMP.Type.configuration = configuration;
+            LAMP.ResearcherSettings.configuration = configuration;
+        },
+        enumerable: false,
+        configurable: true
+    });
+    LAMP.enableDevMode = function () {
+        // Make all future server requests over http
+        // Only use this for local development
+        LAMP.protocol = "http://";
+    };
+    LAMP.addEventListener = function (event, callback) {
+        _bus === null || _bus === void 0 ? void 0 : _bus.addEventListener(event, callback);
+    };
+    LAMP.removeEventListener = function (event, callback) {
+        _bus === null || _bus === void 0 ? void 0 : _bus.removeEventListener(event, callback);
+    };
+    LAMP.dispatchEvent = function (event, detail) {
+        if (detail === void 0) { detail = null; }
+        _bus === null || _bus === void 0 ? void 0 : _bus.dispatchEvent(new CustomEvent(event, { detail: detail }));
+    };
+    //
+    // [Demo API]
+    //
+    LAMP.initializeDemoDB = function (db) {
+        var _a, _b, _c, _d, _e, _f, _g, _h, _j, _k, _l;
+        db = JSON.parse(JSON.stringify(db)); // make a deep copy first!
+        Demo_1.Demo.ActivitySpec = (_a = db.ActivitySpec) !== null && _a !== void 0 ? _a : [];
+        Demo_1.Demo.SensorSpec = (_b = db.SensorSpec) !== null && _b !== void 0 ? _b : [];
+        Demo_1.Demo.Researcher = (_c = db.Researcher) !== null && _c !== void 0 ? _c : [];
+        Demo_1.Demo.Study = (_d = db.Study) !== null && _d !== void 0 ? _d : [];
+        Demo_1.Demo.Participant = (_e = db.Participant) !== null && _e !== void 0 ? _e : [];
+        Demo_1.Demo.Activity = (_f = db.Activity) !== null && _f !== void 0 ? _f : [];
+        Demo_1.Demo.Sensor = (_g = db.Sensor) !== null && _g !== void 0 ? _g : [];
+        Demo_1.Demo.ActivityEvent = (_h = db.ActivityEvent) !== null && _h !== void 0 ? _h : [];
+        Demo_1.Demo.SensorEvent = (_j = db.SensorEvent) !== null && _j !== void 0 ? _j : [];
+        Demo_1.Demo.Credential = (_k = db.Credential) !== null && _k !== void 0 ? _k : [];
+        Demo_1.Demo.Tags = (_l = db.Tags) !== null && _l !== void 0 ? _l : [];
+    };
+    //
+    // [Credential/Identity Management]
+    //
+    // Shorthand for console/data analysis usage.
+    LAMP.connect = function (identity) {
+        if (identity === void 0) { identity = {
+            accessKey: null,
+            secretKey: null,
+            serverAddress: undefined,
+        }; }
+        return __awaiter(this, void 0, void 0, function () {
+            return __generator(this, function (_a) {
+                // Propogate the authorization.
+                // await LAMP.Credential.login(identity.accessKey!, identity.secretKey!);
+                LAMP.Auth._auth = {
+                    id: identity.accessKey,
+                    password: identity.secretKey,
+                    serverAddress: identity.serverAddress,
+                };
+                LAMP.configuration = !!LAMP.Auth._auth.id ? {
+                    base: !!identity.serverAddress ? "https://" + identity.serverAddress : "https://api.lamp.digital",
+                    authorization: LAMP.Auth._auth.id + ":" + LAMP.Auth._auth.password
+                } : {
+                    base: !!identity.serverAddress ? "https://" + identity.serverAddress : "https://api.lamp.digital",
+                };
+                return [2 /*return*/];
+            });
+        });
+    };
+    var _b;
+    LAMP.API = new index_1.APIService();
+    LAMP.Type = new index_1.TypeService();
+    LAMP.Credential = new index_1.CredentialService();
+    LAMP.Researcher = new index_1.ResearcherService();
+    LAMP.Participant = new index_1.ParticipantService();
+    LAMP.Study = new index_1.StudyService();
+    LAMP.Activity = new index_1.ActivityService();
+    LAMP.ActivityEvent = new index_1.ActivityEventService();
+    LAMP.ActivitySpec = new index_1.ActivitySpecService();
+    LAMP.Sensor = new index_1.SensorService();
+    LAMP.SensorEvent = new index_1.SensorEventService();
+    LAMP.SensorSpec = new index_1.SensorSpecService();
+    LAMP.ResearcherSettings = new index_1.ResearcherSettingsService();
+    LAMP.protocol = "https://";
+    LAMP.Auth = (_b = /** @class */ (function () {
+            function class_1() {
+            }
+            /**
+             * Authenticate/authorize as a user of a given `type`.
+             * If all values are null (especially `type`), the authorization is cleared.
+             */
+            class_1.set_identity = function (identity) {
+                var _a;
+                if (identity === void 0) { identity = {
+                    id: null,
+                    password: null,
+                    serverAddress: null,
+                }; }
+                return __awaiter(this, void 0, void 0, function () {
+                    var typeData, e_1, _b, err_1;
+                    return __generator(this, function (_c) {
+                        switch (_c.label) {
+                            case 0:
+                                LAMP.configuration = {
+                                    base: !!identity.serverAddress ? "" + LAMP.protocol + identity.serverAddress : LAMP.protocol + "api.lamp.digital",
+                                };
+                                // Ensure there's actually a change to process.
+                                // let l: IAuth = LAMP.Auth._auth || { id: null, password: null, serverAddress: null }
+                                // if (l.id === identity.id && l.password === identity.password && l.serverAddress === identity.serverAddress) return
+                                // Propogate the authorization.
+                                LAMP.Auth._auth = {
+                                    id: identity.id,
+                                    password: identity.password,
+                                    serverAddress: identity.serverAddress,
+                                };
+                                LAMP.configuration = !!LAMP.Auth._auth.id ? __assign(__assign({}, (LAMP.configuration || { base: undefined, headers: undefined })), { authorization: LAMP.Auth._auth.id + ":" + LAMP.Auth._auth.password }) : __assign({}, (LAMP.configuration || { base: undefined, headers: undefined }));
+                                _c.label = 1;
+                            case 1:
+                                _c.trys.push([1, 9, 10, 11]);
+                                if (!(!!identity.id && !!identity.password)) return [3 /*break*/, 7];
+                                typeData = void 0;
+                                _c.label = 2;
+                            case 2:
+                                _c.trys.push([2, 4, , 5]);
+                                return [4 /*yield*/, LAMP.Type.parent("me")];
+                            case 3:
+                                typeData = _c.sent();
+                                return [3 /*break*/, 5];
+                            case 4:
+                                e_1 = _c.sent();
+                                return [3 /*break*/, 5];
+                            case 5:
+                                LAMP.Auth._type =
+                                    typeData.data === "admin"
+                                        ? "admin"
+                                        : Object.entries(typeData.data).length === 0
+                                            ? "researcher"
+                                            : !!typeData.data
+                                                ? "participant"
+                                                : null;
+                                // Get our 'me' object now that we figured out our type.
+                                _b = LAMP.Auth;
+                                return [4 /*yield*/, (LAMP.Auth._type === "admin"
+                                        ? { id: identity.id }
+                                        : LAMP.Auth._type === "researcher"
+                                            ? LAMP.Researcher.view("me")
+                                            : LAMP.Participant.view("me"))];
+                            case 6:
+                                // Get our 'me' object now that we figured out our type.
+                                _b._me = _c.sent();
+                                LAMP.dispatchEvent("LOGIN", {
+                                    authorizationToken: LAMP.configuration.authorization,
+                                    // authorizationToken: LAMP.configuration.token,
+                                    identityObject: LAMP.Auth._me,
+                                    serverAddress: LAMP.configuration.base,
+                                    accessToken: LAMP.configuration.accessToken,
+                                    refreshToken: LAMP.configuration.refreshToken,
+                                });
+                                return [3 /*break*/, 8];
+                            case 7:
+                                LAMP.dispatchEvent("LOGOUT", {
+                                    deleteCache: true,
+                                });
+                                _c.label = 8;
+                            case 8: return [3 /*break*/, 11];
+                            case 9:
+                                err_1 = _c.sent();
+                                console.log("#####LAMP err", err_1);
+                                // We failed: clear and propogate the authorization.
+                                LAMP.Auth._auth = { id: null, password: null, serverAddress: null };
+                                // if (!!LAMP.configuration) LAMP.configuration.token = undefined
+                                // if (!!LAMP.configuration) LAMP.configuration.authorization = undefined
+                                // Delete the "self" identity and throw the error we received.
+                                LAMP.Auth._me = null;
+                                LAMP.Auth._type = null;
+                                throw new Error("invalid id or password");
+                            case 10:
+                                // Save the authorization in sessionStorage for later.
+                                ;
+                                (_a = global.sessionStorage) === null || _a === void 0 ? void 0 : _a.setItem("LAMP._auth", JSON.stringify(LAMP.Auth._auth));
+                                return [7 /*endfinally*/];
+                            case 11: return [2 /*return*/];
+                        }
+                    });
+                });
+            };
+            class_1.refresh_identity = function () {
+                var _a, _b;
+                return __awaiter(this, void 0, void 0, function () {
+                    var _saved;
+                    return __generator(this, function (_c) {
+                        switch (_c.label) {
+                            case 0:
+                                _saved = JSON.parse((_b = (_a = global.sessionStorage) === null || _a === void 0 ? void 0 : _a.getItem("LAMP._auth")) !== null && _b !== void 0 ? _b : "null") || LAMP.Auth._auth;
+                                return [4 /*yield*/, LAMP.Auth.set_identity({
+                                        id: _saved.id,
+                                        password: _saved.password,
+                                        serverAddress: _saved.serverAddress,
+                                    })];
+                            case 1:
+                                _c.sent();
+                                return [2 /*return*/];
+                        }
+                    });
+                });
+            };
+            return class_1;
+        }()),
+        _b._auth = { id: null, password: null, serverAddress: null },
+        _b._type = null,
+        _b);
+    return LAMP;
+}());
+exports.default = LAMP;
+exports.main = function () {
+    if (process === undefined) {
+        console.error("This function cannot be invoked from within the library.");
+        return;
+    }
+    console.log("This command-line tool is currently disabled.");
+    process === null || process === void 0 ? void 0 : process.exit(1);
+};