lamp-core-lst 2025.11.1-3.basic

package/src/service/Study.service.ts

@@ -0,0 +1,187 @@
+import { Fetch, Configuration } from "./Fetch"
+import { Identifier } from "../model/Type"
+import { Study } from "../model/Study"
+import { Demo } from "./Demo"
+import jsonata from "jsonata"
+
+export class StudyService {
+  public configuration?: Configuration
+
+  /**
+   * Get the set of all studies.
+   */
+  public async all(transform?: string): Promise<Study[]> {
+    if (this.configuration.base === "https://demo.lamp.digital") {
+      // DEMO
+      let auth = (this.configuration.authorization || ":").split(":")
+      let credential = Demo.Credential.filter(x => x["access_key"] === auth[0] && x["secret_key"] === auth[1])
+      if (credential.length === 0) return Promise.resolve({ error: "403.invalid-credentials" } as any)
+
+      let output = Demo.Study.map(x => Object.assign(new Study(), x))
+      output = typeof transform === "string" ? jsonata(transform).evaluate(output) : output
+      return Promise.resolve(output)
+    }
+    return (await Fetch.get<{ data: any[] }>(`/study`, this.configuration)).data.map(x => Object.assign(new Study(), x))
+  }
+
+  /**
+   * Get the set of studies for a single researcher.
+   * @param researcherId
+   */
+  public async allByResearcher(researcherId: Identifier, transform?: string): Promise<Study[]> {
+    if (researcherId === null || researcherId === undefined)
+      throw new Error("Required parameter researcherId was null or undefined when calling studyAllByResearcher.")
+
+    if (this.configuration.base === "https://demo.lamp.digital") {
+      // DEMO
+      let auth = (this.configuration.authorization || ":").split(":")
+      let credential = Demo.Credential.filter(x => x["access_key"] === auth[0] && x["secret_key"] === auth[1])
+      if (credential.length === 0) return Promise.resolve({ error: "403.invalid-credentials" } as any)
+      if (researcherId === "me") researcherId = credential.length > 0 ? credential[0]["origin"] : researcherId
+
+      if (Demo.Researcher.filter(x => x["id"] === researcherId).length > 0) {
+        let output = Demo.Study.filter(x => x["#parent"] === researcherId).map(x => Object.assign(new Study(), x))
+        output = typeof transform === "string" ? jsonata(transform).evaluate(output) : output
+        return Promise.resolve(output)
+      } else {
+        return Promise.resolve({ error: "404.not-found" } as any)
+      }
+    }
+    return (await Fetch.get<{ data: any[] }>(`/researcher/${researcherId}/study`, this.configuration)).data.map(x =>
+      Object.assign(new Study(), x)
+    )
+  }
+
+  /**
+   * Create a new Study for the given Researcher.
+   * @param researcherId
+   * @param study
+   */
+  public async create(researcherId: Identifier, study: Study): Promise<Identifier> {
+    if (researcherId === null || researcherId === undefined)
+      throw new Error("Required parameter researcherId was null or undefined when calling studyCreate.")
+    if (study === null || study === undefined)
+      throw new Error("Required parameter study was null or undefined when calling studyCreate.")
+
+    if (this.configuration.base === "https://demo.lamp.digital") {
+      // DEMO
+      let auth = (this.configuration.authorization || ":").split(":")
+      let credential = Demo.Credential.filter(x => x["access_key"] === auth[0] && x["secret_key"] === auth[1])
+      if (credential.length === 0) return Promise.resolve({ error: "403.invalid-credentials" } as any)
+      if (researcherId === "me") researcherId = credential.length > 0 ? credential[0]["origin"] : researcherId
+
+      if (Demo.Researcher.filter(x => x["id"] === researcherId).length > 0) {
+        return Promise.resolve({ error: "500.demo-restriction" } as any)
+      } else {
+        return Promise.resolve({ error: "404.not-found" } as any)
+      }
+    }
+    return await Fetch.post(`/researcher/${researcherId}/study`, study, this.configuration)
+  }
+
+  /**
+   * Delete a study.
+   * @param studyId
+   */
+  public async delete(studyId: Identifier): Promise<Identifier> {
+    if (studyId === null || studyId === undefined)
+      throw new Error("Required parameter studyId was null or undefined when calling studyDelete.")
+
+    if (this.configuration.base === "https://demo.lamp.digital") {
+      // DEMO
+      let auth = (this.configuration.authorization || ":").split(":")
+      let credential = Demo.Credential.filter(x => x["access_key"] === auth[0] && x["secret_key"] === auth[1])
+      if (credential.length === 0) return Promise.resolve({ error: "403.invalid-credentials" } as any)
+      if (studyId === "me") studyId = credential.length > 0 ? credential[0]["origin"] : studyId
+
+      if (Demo.Study.filter(x => x["id"] === studyId).length > 0) {
+        return Promise.resolve({ error: "500.demo-restriction" } as any)
+      } else {
+        return Promise.resolve({ error: "404.not-found" } as any)
+      }
+    }
+    return await Fetch.delete(`/study/${studyId}`, this.configuration)
+  }
+
+  /**
+   * Update the study.
+   * @param studyId
+   * @param study
+   */
+  public async update(studyId: Identifier, study: Study): Promise<Identifier> {
+    if (studyId === null || studyId === undefined)
+      throw new Error("Required parameter studyId was null or undefined when calling studyUpdate.")
+    if (study === null || study === undefined)
+      throw new Error("Required parameter study was null or undefined when calling studyUpdate.")
+
+    if (this.configuration.base === "https://demo.lamp.digital") {
+      // DEMO
+      let auth = (this.configuration.authorization || ":").split(":")
+      let credential = Demo.Credential.filter(x => x["access_key"] === auth[0] && x["secret_key"] === auth[1])
+      if (credential.length === 0) return Promise.resolve({ error: "403.invalid-credentials" } as any)
+      if (studyId === "me") studyId = credential.length > 0 ? credential[0]["origin"] : studyId
+
+      if (Demo.Study.filter(x => x["id"] === studyId).length > 0) {
+        return Promise.resolve({ error: "500.demo-restriction" } as any)
+      } else {
+        return Promise.resolve({ error: "404.not-found" } as any)
+      }
+    }
+    return await Fetch.put(`/study/${studyId}`, study, this.configuration)
+  }
+
+  /**
+   * Get a single study, by identifier.
+   * @param studyId
+   */
+  public async view(studyId: Identifier, transform?: string): Promise<Study> {
+    if (studyId === null || studyId === undefined)
+      throw new Error("Required parameter studyId was null or undefined when calling studyView.")
+
+    if (this.configuration.base === "https://demo.lamp.digital") {
+      // DEMO
+      let auth = (this.configuration.authorization || ":").split(":")
+      let credential = Demo.Credential.filter(x => x["access_key"] === auth[0] && x["secret_key"] === auth[1])
+      if (credential.length === 0) return Promise.resolve({ error: "403.invalid-credentials" } as any)
+      if (studyId === "me") studyId = credential.length > 0 ? credential[0]["origin"] : studyId
+
+      let data = Demo.Study.filter(x => x["id"] === studyId).map(x => Object.assign(new Study(), x))
+      if (data.length > 0) {
+        let output = data[0]
+        output = typeof transform === "string" ? jsonata(transform).evaluate(output) : output
+        return Promise.resolve(output)
+      } else {
+        return Promise.resolve({ error: "404.not-found" } as any)
+      }
+    }
+    return (await Fetch.get<{ data: any[] }>(`/study/${studyId}`, this.configuration)).data.map(x =>
+      Object.assign(new Study(), x)
+    )[0]
+  }
+/**
+   * Get a single study, by identifier.
+   * @param studyId
+   */
+  public async lookup(studyId: Identifier, mode:number, transform?: string): Promise<any> {
+    if (studyId === null || studyId === undefined)
+      throw new Error("Required parameter studyId was null or undefined when calling studyView.")
+
+    if (this.configuration.base === "https://demo.lamp.digital") {
+      // DEMO
+      let auth = (this.configuration.authorization || ":").split(":")
+      let credential = Demo.Credential.filter(x => x["access_key"] === auth[0] && x["secret_key"] === auth[1])
+      if (credential.length === 0) return Promise.resolve({ error: "403.invalid-credentials" } as any)
+      if (studyId === "me") studyId = credential.length > 0 ? credential[0]["origin"] : studyId
+
+      let data = Demo.Study.filter(x => x["id"] === studyId).map(x => Object.assign(new Study(), x))
+      if (data.length > 0) {
+        let output = data[0]
+        output = typeof transform === "string" ? jsonata(transform).evaluate(output) : output
+        return Promise.resolve(output)
+      } else {
+        return Promise.resolve({ error: "404.not-found" } as any)
+      }
+    }
+    return (await Fetch.get<{ data: any[] }>(`/study/${studyId}/_lookup/participant/mode/${mode}`, this.configuration))
+  }
+}

package/src/service/Type.service.ts

@@ -0,0 +1,297 @@
+import { Fetch, Configuration } from "./Fetch"
+import { Identifier } from "../model/Type"
+import { DynamicAttachment } from "../model/DynamicAttachment"
+import { Demo } from "./Demo"
+import jsonata from "jsonata"
+
+export class TypeService {
+  public configuration?: Configuration
+
+  /**
+   *
+   * @param typeId
+   * @param attachmentKey
+   */
+  public async getAttachment(typeId: Identifier, attachmentKey: string): Promise<any[]> {
+    if (attachmentKey === null || attachmentKey === undefined)
+      throw new Error("Required parameter attachmentKey was null or undefined when calling typeGetAttachment.")
+
+    if (this.configuration.base === "https://demo.lamp.digital") {
+      // DEMO
+      let auth = (this.configuration.authorization || ":").split(":")
+      let credential = Demo.Credential.filter(x => x["access_key"] === auth[0] && x["secret_key"] === auth[1])
+      if (credential.length === 0) return Promise.resolve({ error: "403.invalid-credentials" } as any)
+      if (typeId === "me") typeId = credential.length > 0 ? credential[0]["origin"] : typeId
+
+      let exists = [].concat(
+        Demo.Researcher.filter(x => x["id"] === typeId),
+        Demo.Study.filter(x => x["id"] === typeId),
+        Demo.Participant.filter(x => x["id"] === typeId),
+        Demo.Activity.filter(x => x["id"] === typeId) // ???
+      )
+      if (exists.length > 0) {
+        // FIXME: Sibling Tags? (Participant, Activity, Sensor)
+        const ancestors = (obj: any) =>
+          obj["#type"] === "Researcher"
+            ? []
+            : obj["#type"] === "Study"
+            ? [obj["#parent"]]
+            : obj["#type"] === "Participant"
+            ? [obj["#parent"], Demo.Study.filter(x => x["id"] === obj["#parent"]).map(x => x["#parent"])[0]]
+            : obj["#type"] === "Activity"
+            ? [obj["#parent"], Demo.Study.filter(x => x["id"] === obj["#parent"]).map(x => x["#parent"])[0]]
+            : []
+        const tagSelf = (tag: any) => [typeId].includes(tag["#parent"]) && [typeId, "me"].includes(tag["target"]) // implicit & explicit
+        const tagParent = (tag: any) =>
+          ancestors(exists[0]).includes(tag["#parent"]) && [typeId, exists[0]["#type"]].includes(tag["target"]) // implicit & explicit
+        let data = Demo.Tags.filter(x => (tagSelf(x) || tagParent(x)) && x["key"] === attachmentKey)
+        return Promise.resolve(
+          data.length > 0 ? ({ data: data[0]["value"] } as any) : ({ error: "404.not-found" } as any)
+        )
+      } else {
+        return Promise.resolve({ error: "404.not-found" } as any)
+      }
+    }
+    return await Fetch.get(`/type/${typeId}/attachment/${attachmentKey}`, this.configuration)
+  }
+
+  /**
+   *
+   * @param typeId
+   * @param attachmentKey
+   * @param invokeAlways
+   * @param includeLogs
+   * @param ignoreOutput
+   */
+  public async getDynamicAttachment(
+    typeId: Identifier,
+    attachmentKey: string,
+    invokeAlways: boolean,
+    includeLogs: boolean,
+    ignoreOutput: boolean
+  ): Promise<DynamicAttachment[]> {
+    if (attachmentKey === null || attachmentKey === undefined)
+      throw new Error("Required parameter attachmentKey was null or undefined when calling typeGetDynamicAttachment.")
+    if (invokeAlways === null || invokeAlways === undefined)
+      throw new Error("Required parameter invokeAlways was null or undefined when calling typeGetDynamicAttachment.")
+    if (includeLogs === null || includeLogs === undefined)
+      throw new Error("Required parameter includeLogs was null or undefined when calling typeGetDynamicAttachment.")
+    if (ignoreOutput === null || ignoreOutput === undefined)
+      throw new Error("Required parameter ignoreOutput was null or undefined when calling typeGetDynamicAttachment.")
+
+    let queryParameters = new URLSearchParams()
+    if (invokeAlways !== undefined && invokeAlways !== null) queryParameters.set("invoke_always", <any>invokeAlways)
+    if (includeLogs !== undefined && includeLogs !== null) queryParameters.set("include_logs", <any>includeLogs)
+    if (ignoreOutput !== undefined && ignoreOutput !== null) queryParameters.set("ignore_output", <any>ignoreOutput)
+
+    if (this.configuration.base === "https://demo.lamp.digital") {
+      // DEMO
+      return Promise.resolve({ error: "500.demo-restriction" } as any)
+    }
+    return await Fetch.get(
+      `/type/${typeId}/attachment/dynamic/${attachmentKey}?${queryParameters.toString()}`,
+      this.configuration
+    )
+  }
+
+  /**
+   *
+   * @param typeId
+   */
+  public async listAttachments(typeId: Identifier): Promise<any[]> {
+   
+    if (this.configuration.base === "https://demo.lamp.digital") {
+      // DEMO
+      let auth = (this.configuration.authorization || ":").split(":")
+      let credential = Demo.Credential.filter(x => x["access_key"] === auth[0] && x["secret_key"] === auth[1])
+      if (credential.length === 0) return Promise.resolve({ error: "403.invalid-credentials" } as any)
+      if (typeId === "me") typeId = credential.length > 0 ? credential[0]["origin"] : typeId
+
+      let exists = [].concat(
+        Demo.Researcher.filter(x => x["id"] === typeId),
+        Demo.Study.filter(x => x["id"] === typeId),
+        Demo.Participant.filter(x => x["id"] === typeId),
+        Demo.Activity.filter(x => x["id"] === typeId) // ???
+      )
+      if (exists.length > 0) {
+        // FIXME: Sibling Tags? (Participant, Activity, Sensor)
+        const ancestors = (obj: any) =>
+          obj["#type"] === "Researcher"
+            ? []
+            : obj["#type"] === "Study"
+            ? [obj["#parent"]]
+            : obj["#type"] === "Participant"
+            ? [obj["#parent"], Demo.Study.filter(x => x["id"] === obj["#parent"]).map(x => x["#parent"])[0]]
+            : obj["#type"] === "Activity"
+            ? [obj["#parent"], Demo.Study.filter(x => x["id"] === obj["#parent"]).map(x => x["#parent"])[0]]
+            : []
+        const tagSelf = (tag: any) => [typeId].includes(tag["#parent"]) && [typeId, "me"].includes(tag["target"]) // implicit & explicit
+        const tagParent = (tag: any) =>
+          ancestors(exists[0]).includes(tag["#parent"]) && [typeId, exists[0]["#type"]].includes(tag["target"]) // implicit & explicit
+        return Promise.resolve({ data: Demo.Tags.filter(x => tagSelf(x) || tagParent(x)).map(x => x.key) } as any)
+      } else {
+        return Promise.resolve({ error: "404.not-found" } as any)
+      }
+    }
+    return await Fetch.get(`/type/${typeId}/attachment`, this.configuration)
+  }
+
+  /**
+   * Get the parent type identifier of the data structure referenced by the identifier.
+   * @param typeId
+   */
+  public async parent(typeId: Identifier, transform?: string): Promise<any> {
+   
+    if (this.configuration.base === "https://demo.lamp.digital") {
+      // DEMO
+      let auth = (this.configuration.authorization || ":").split(":")
+      let credential = Demo.Credential.filter(x => x["access_key"] === auth[0] && x["secret_key"] === auth[1])
+      if (credential.length === 0) return Promise.resolve({ error: "403.invalid-credentials" } as any)
+      if (typeId === "me") typeId = credential.length > 0 ? credential[0]["origin"] : typeId
+
+      let possible = []
+      possible = Demo.Researcher.filter(x => x["id"] === typeId)
+      if (possible.length > 0) {
+        let output = { data: {} } as any
+        output = typeof transform === "string" ? jsonata(transform).evaluate(output) : output
+        return Promise.resolve(output)
+      }
+      possible = Demo.Study.filter(x => x["id"] === typeId)
+      if (possible.length > 0) {
+        let output = { data: { Researcher: possible[0]["#parent"] } } as any
+        output = typeof transform === "string" ? jsonata(transform).evaluate(output) : output
+        return Promise.resolve(output)
+      }
+      possible = Demo.Participant.filter(x => x["id"] === typeId)
+      if (possible.length > 0) {
+        let output = {
+          data: {
+            Researcher: Demo.Study.filter(x => x["id"] === possible[0]["#parent"])[0],
+            Study: possible[0]["#parent"]
+          }
+        } as any
+        output = typeof transform === "string" ? jsonata(transform).evaluate(output) : output
+        return Promise.resolve(output)
+      }
+      possible = Demo.Activity.filter(x => x["id"] === typeId)
+      if (possible.length > 0) {
+        let output = {
+          data: {
+            Researcher: Demo.Study.filter(x => x["id"] === possible[0]["#parent"])[0],
+            Study: possible[0]["#parent"]
+          }
+        } as any
+        output = typeof transform === "string" ? jsonata(transform).evaluate(output) : output
+        return Promise.resolve(output)
+      }
+      return Promise.resolve({ error: "404.not-found" } as any)
+    }
+    return await Fetch.get(`/type/${typeId}/parent`, this.configuration)
+  }
+
+  /**
+   *
+   * @param typeId
+   * @param target
+   * @param attachmentKey
+   * @param attachmentValue
+   */
+  public async setAttachment(
+    typeId: Identifier,
+    target: string,
+    attachmentKey: string,
+    attachmentValue: any
+  ): Promise<Identifier> {
+    if (target === null || target === undefined)
+      throw new Error("Required parameter target was null or undefined when calling typeSetAttachment.")
+    if (attachmentKey === null || attachmentKey === undefined)
+      throw new Error("Required parameter attachmentKey was null or undefined when calling typeSetAttachment.")
+    if (attachmentValue === undefined)
+      throw new Error("Required parameter attachmentValue was null or undefined when calling typeSetAttachment.")
+
+    if (this.configuration.base === "https://demo.lamp.digital") {
+      // DEMO
+      let auth = (this.configuration.authorization || ":").split(":")
+      let credential = Demo.Credential.filter(x => x["access_key"] === auth[0] && x["secret_key"] === auth[1])
+      if (credential.length === 0) return Promise.resolve({ error: "403.invalid-credentials" } as any)
+      if (typeId === "me") typeId = credential.length > 0 ? credential[0]["origin"] : typeId
+
+      let exists = [].concat(
+        Demo.Researcher.filter(x => x["id"] === typeId),
+        Demo.Study.filter(x => x["id"] === typeId),
+        Demo.Participant.filter(x => x["id"] === typeId),
+        Demo.Activity.filter(x => x["id"] === typeId) // ???
+      )
+      if (exists.length > 0) {
+        // FIXME: Sibling Tags? (Participant, Activity, Sensor)
+        if (attachmentValue === null) {
+          // DELETE
+          Demo.Tags = Demo.Tags.filter(
+            x => !(x["#parent"] === typeId && x["target"] === target && x["key"] === attachmentKey)
+          )
+        } else {
+          let idx = Demo.Tags.findIndex(
+            x => x["#parent"] === typeId && x["target"] === target && x["key"] === attachmentKey
+          )
+          if (idx >= 0) {
+            // UPDATE
+            console.dir("update")
+            Demo.Tags[idx]["value"] = attachmentValue
+          } else {
+            // INSERT
+            console.dir("insert")
+            Demo.Tags.push({
+              "#type": "Tag",
+              "#parent": typeId,
+              target: target,
+              key: attachmentKey,
+              value: attachmentValue
+            })
+          }
+        }
+        return Promise.resolve({} as any)
+      } else {
+        return Promise.resolve({ error: "404.not-found" } as any)
+      }
+    }
+    return await Fetch.put(`/type/${typeId}/attachment/${attachmentKey}/${target}`, attachmentValue, this.configuration)
+  }
+
+  /**
+   *
+   * @param invokeOnce
+   * @param typeId
+   * @param target
+   * @param attachmentKey
+   * @param attachmentValue
+   */
+  public async setDynamicAttachment(
+    invokeOnce: boolean,
+    typeId: Identifier,
+    target: string,
+    attachmentKey: string,
+    attachmentValue: DynamicAttachment
+  ): Promise<Identifier> {
+    if (invokeOnce === null || invokeOnce === undefined)
+      throw new Error("Required parameter invokeOnce was null or undefined when calling typeSetDynamicAttachment.")
+    if (target === null || target === undefined)
+      throw new Error("Required parameter target was null or undefined when calling typeSetDynamicAttachment.")
+    if (attachmentKey === null || attachmentKey === undefined)
+      throw new Error("Required parameter attachmentKey was null or undefined when calling typeSetDynamicAttachment.")
+    if (attachmentValue === null || attachmentValue === undefined)
+      throw new Error("Required parameter attachmentValue was null or undefined when calling typeSetDynamicAttachment.")
+
+    let queryParameters = new URLSearchParams()
+    if (invokeOnce !== undefined && invokeOnce !== null) queryParameters.set("invoke_once", <any>invokeOnce)
+
+    if (this.configuration.base === "https://demo.lamp.digital") {
+      // DEMO
+      return Promise.resolve({ error: "500.demo-restriction" } as any)
+    }
+    return await Fetch.put(
+      `/type/${typeId}/attachment/dynamic/${attachmentKey}/${target}?${queryParameters.toString()}`,
+      attachmentValue,
+      this.configuration
+    )
+  }
+}

package/src/service/index.ts

@@ -0,0 +1,13 @@
+export * from "./Activity.service"
+export * from "./ActivityEvent.service"
+export * from "./ActivitySpec.service"
+export * from "./Credential.service"
+export * from "./Participant.service"
+export * from "./Researcher.service"
+export * from "./ResearcherSettings.service"
+export * from "./Sensor.service"
+export * from "./SensorEvent.service"
+export * from "./SensorSpec.service"
+export * from "./Study.service"
+export * from "./Type.service"
+export * from "./API.service"

package/tsconfig.json

@@ -0,0 +1,29 @@
+{
+  "compilerOptions": {
+    "target": "es5",
+    "lib": [
+      "dom",
+      "dom.iterable",
+      "esnext"
+    ],
+    "declaration": true,
+    "allowJs": true,
+    "skipLibCheck": true,
+    "esModuleInterop": true,
+    "allowSyntheticDefaultImports": true,
+    "alwaysStrict": true,
+    "forceConsistentCasingInFileNames": true,
+    "module": "commonjs",
+    "resolveJsonModule": true,
+    "isolatedModules": true,
+    "jsx": "preserve",
+    "outDir": "dist"
+  },
+  "include": [
+    "src"
+  ],
+  "exclude": [
+    "node_modules",
+    "dist"
+  ]
+}