lamp-core-lst 2025.1.16

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/TESTING_DISPATCH_EVENT.md

@@ -0,0 +1,192 @@
+# Testing LAMP.dispatchEvent in Browser Console
+
+## Overview
+`LAMP.dispatchEvent` is an event system that allows components to communicate via custom events. You can test it directly from the browser console when the LAMP-dashboard is running.
+
+## Basic Usage
+
+### 1. Add an Event Listener
+```javascript
+// Listen for a custom event
+LAMP.addEventListener("MY_TEST_EVENT", (event) => {
+  console.log("Event received:", event.detail);
+});
+
+// Listen for LOGIN events (already used by LAMP)
+LAMP.addEventListener("LOGIN", (event) => {
+  console.log("Login event:", event.detail);
+  console.log("Identity:", event.detail.identityObject);
+  console.log("Server:", event.detail.serverAddress);
+});
+
+// Listen for LOGOUT events
+LAMP.addEventListener("LOGOUT", (event) => {
+  console.log("Logout event:", event.detail);
+});
+```
+
+### 2. Dispatch a Test Event
+```javascript
+// Dispatch a simple test event
+LAMP.dispatchEvent("MY_TEST_EVENT", { message: "Hello from console!" });
+
+// Dispatch with more complex data
+LAMP.dispatchEvent("MY_TEST_EVENT", {
+  timestamp: Date.now(),
+  data: { key: "value" },
+  user: "test-user"
+});
+```
+
+### 3. Remove an Event Listener
+```javascript
+// Create a named function for the listener
+const myHandler = (event) => {
+  console.log("Event:", event.detail);
+};
+
+// Add listener
+LAMP.addEventListener("MY_TEST_EVENT", myHandler);
+
+// Remove listener
+LAMP.removeEventListener("MY_TEST_EVENT", myHandler);
+```
+
+## Testing Existing Events
+
+### Test LOGIN Event
+```javascript
+// Add listener first
+LAMP.addEventListener("LOGIN", (event) => {
+  console.log("LOGIN Event Details:", event.detail);
+});
+
+// Trigger login (this will also dispatch LOGIN event automatically)
+// But you can also manually test it:
+LAMP.dispatchEvent("LOGIN", {
+  authorizationToken: "test:token",
+  identityObject: { id: "test-user", name: "Test User" },
+  serverAddress: "https://api.lamp.digital",
+  accessToken: "access-token",
+  refreshToken: "refresh-token"
+});
+```
+
+### Test LOGOUT Event
+```javascript
+// Add listener
+LAMP.addEventListener("LOGOUT", (event) => {
+  console.log("LOGOUT Event:", event.detail);
+});
+
+// Dispatch logout
+LAMP.dispatchEvent("LOGOUT", {
+  deleteCache: true
+});
+```
+
+## Complete Testing Example
+
+```javascript
+// Step 1: Set up listeners for all events you want to test
+const eventLog = [];
+
+// Generic event logger
+const logEvent = (eventName) => (event) => {
+  const logEntry = {
+    event: eventName,
+    timestamp: new Date().toISOString(),
+    detail: event.detail
+  };
+  eventLog.push(logEntry);
+  console.log(`[${eventName}]`, logEntry);
+};
+
+// Add listeners
+LAMP.addEventListener("LOGIN", logEvent("LOGIN"));
+LAMP.addEventListener("LOGOUT", logEvent("LOGOUT"));
+LAMP.addEventListener("MY_TEST_EVENT", logEvent("MY_TEST_EVENT"));
+
+// Step 2: Dispatch test events
+LAMP.dispatchEvent("MY_TEST_EVENT", { test: "data" });
+LAMP.dispatchEvent("LOGIN", { 
+  identityObject: { id: "test" },
+  serverAddress: "https://test.com"
+});
+
+// Step 3: View all logged events
+console.log("All Events:", eventLog);
+
+// Step 4: Check if LAMP object is available
+console.log("LAMP object:", LAMP);
+console.log("LAMP.dispatchEvent:", LAMP.dispatchEvent);
+console.log("LAMP.addEventListener:", LAMP.addEventListener);
+```
+
+## Debugging Tips
+
+### Check if LAMP is loaded
+```javascript
+// In browser console
+typeof LAMP !== 'undefined' && LAMP.dispatchEvent
+// Should return: function dispatchEvent() { ... }
+```
+
+### Monitor all dispatched events
+```javascript
+// Override dispatchEvent temporarily to log all events
+const originalDispatch = LAMP.dispatchEvent;
+LAMP.dispatchEvent = function(event, detail) {
+  console.log("Dispatching:", event, detail);
+  return originalDispatch.call(this, event, detail);
+};
+
+// Now all events will be logged
+LAMP.dispatchEvent("TEST", { data: "test" });
+
+// Restore original
+LAMP.dispatchEvent = originalDispatch;
+```
+
+### Check event bus
+```javascript
+// The internal event bus is a DOM element
+// You can inspect it (though it's private)
+// Events are dispatched using CustomEvent API
+```
+
+## Common Use Cases
+
+### 1. Test Activity Completion Events
+```javascript
+LAMP.addEventListener("ACTIVITY_COMPLETE", (event) => {
+  console.log("Activity completed:", event.detail);
+});
+
+LAMP.dispatchEvent("ACTIVITY_COMPLETE", {
+  activityId: "test-activity-123",
+  participantId: "test-participant",
+  timestamp: Date.now()
+});
+```
+
+### 2. Test Data Sync Events
+```javascript
+LAMP.addEventListener("DATA_SYNC", (event) => {
+  console.log("Data synced:", event.detail);
+});
+
+LAMP.dispatchEvent("DATA_SYNC", {
+  type: "activities",
+  count: 10,
+  timestamp: Date.now()
+});
+```
+
+## Notes
+- Events use the browser's native CustomEvent API
+- The event bus is an internal HTMLElement (`_bus`)
+- Events are synchronous - listeners are called immediately
+- Multiple listeners can be attached to the same event
+- Event details are passed in the `detail` property of the event object
+

package/cli.js

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

package/dist/index.d.ts

@@ -0,0 +1,74 @@
+import "isomorphic-fetch";
+import { Researcher, Participant } from "./model/index";
+import { APIService, ActivityService, ActivityEventService, ActivitySpecService, CredentialService, ParticipantService, ResearcherService, SensorService, SensorEventService, SensorSpecService, StudyService, TypeService, ResearcherSettingsService, ImageUploadService } 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;
+    static ImageUpload: ImageUploadService;
+    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>;
+    /**
+     * Connect using Bearer token authentication (JWT).
+     * Use this for server-to-server communication where you have an access token.
+     * @param options - Connection options with accessToken and serverAddress
+     */
+    static connectWithToken(options: {
+        accessToken: string;
+        serverAddress: string;
+    }): 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;