lamp-core-lst 2025.11.19 → 2025.12.0-1.1

package/dist/index.d.ts

@@ -1,6 +1,6 @@
 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";
+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";
 /**
@@ -29,6 +29,7 @@ export default class LAMP {
     static SensorEvent: SensorEventService;
     static SensorSpec: SensorSpecService;
     static ResearcherSettings: ResearcherSettingsService;
+    static ImageUpload: ImageUploadService;
     private static get configuration();
     private static set configuration(value);
     private static protocol;

package/dist/index.js

@@ -90,6 +90,7 @@ var LAMP = /** @class */ (function () {
             LAMP.Study.configuration = configuration;
             LAMP.Type.configuration = configuration;
             LAMP.ResearcherSettings.configuration = configuration;
+            LAMP.ImageUpload.configuration = configuration;
         },
         enumerable: false,
         configurable: true
@@ -170,6 +171,7 @@ var LAMP = /** @class */ (function () {
     LAMP.SensorEvent = new index_1.SensorEventService();
     LAMP.SensorSpec = new index_1.SensorSpecService();
     LAMP.ResearcherSettings = new index_1.ResearcherSettingsService();
+    LAMP.ImageUpload = new index_1.ImageUploadService();
     LAMP.protocol = "https://";
     LAMP.Auth = (_b = /** @class */ (function () {
             function class_1() {

package/dist/model/Activity.d.ts

@@ -73,6 +73,10 @@ export declare class Activity {
      * The tab settings for the activity.
      */
     category?: Tab[] | null;
+    /**
+     * The photo/image URL for the activity (stored in Azure Blob Storage).
+     */
+    photo?: any;
     /**
      * The type of streak for the activity.
      */

package/dist/model/ResearcherSettings.d.ts

@@ -43,6 +43,18 @@ export declare class ResearcherSettings {
      * The featured activity
      */
     featuredActivity?: string;
+    /**
+     * The streak type
+     */
+    streakType?: string;
+    /**
+     * The Streak title
+     */
+    streakTitle?: string;
+    /**
+     * The Streak description
+     */
+    streakDesc?: string;
     /**
      * The timestamp
      */

package/dist/service/Activity.service.d.ts

@@ -23,8 +23,15 @@ export declare class ActivityService {
     /**
      * Get the set of all activities available to  participants of a single study, by study identifier.
      * @param studyId
+     * @param transform
+     * @param ignore_binary
+     * @param limit Optional limit for pagination
+     * @param offset Optional offset for pagination
      */
-    allByStudy(studyId: Identifier, transform?: string, ignore_binary?: boolean): Promise<Activity[]>;
+    allByStudy(studyId: Identifier, transform?: string, ignore_binary?: boolean, limit?: number, offset?: number): Promise<Activity[] | {
+        data: Activity[];
+        total: number;
+    }>;
     /**
      * Get the set of all activities available to  participants of a single study, by participant identifier.
      * @param participantId

package/dist/service/Activity.service.js

@@ -199,13 +199,17 @@ var ActivityService = /** @class */ (function () {
     /**
      * Get the set of all activities available to  participants of a single study, by study identifier.
      * @param studyId
+     * @param transform
+     * @param ignore_binary
+     * @param limit Optional limit for pagination
+     * @param offset Optional offset for pagination
      */
-    ActivityService.prototype.allByStudy = function (studyId, transform, ignore_binary) {
-        var _a, _b;
+    ActivityService.prototype.allByStudy = function (studyId, transform, ignore_binary, limit, offset) {
+        var _a;
         return __awaiter(this, void 0, void 0, function () {
-            var auth_4, credential, output;
-            return __generator(this, function (_c) {
-                switch (_c.label) {
+            var auth_4, credential, output, total, paginatedOutput, params, queryString, result, activitiesArray, totalCount, mappedActivities;
+            return __generator(this, function (_b) {
+                switch (_b.label) {
                     case 0:
                         if (studyId === null || studyId === undefined)
                             throw new Error("Required parameter studyId was null or undefined when calling activityAllByStudy.");
@@ -221,14 +225,53 @@ var ActivityService = /** @class */ (function () {
                             if (Demo_1.Demo.Study.filter(function (x) { return x["id"] === studyId; }).length > 0) {
                                 output = (_a = Demo_1.Demo.Activity.filter(function (x) { return x["#parent"] === studyId; })) === null || _a === void 0 ? void 0 : _a.map(function (x) { return Object.assign(new Activity_1.Activity(), x); });
                                 output = typeof transform === "string" ? jsonata_1.default(transform).evaluate(output) : output;
+                                // If pagination is requested, return paginated result with total
+                                if (typeof limit === 'number' && limit > 0 || typeof offset === 'number' && offset > 0) {
+                                    total = output.length;
+                                    paginatedOutput = limit !== undefined && offset !== undefined
+                                        ? output.slice(offset, offset + limit)
+                                        : output;
+                                    return [2 /*return*/, Promise.resolve({ data: paginatedOutput, total: total })];
+                                }
                                 return [2 /*return*/, Promise.resolve(output)];
                             }
                             else {
                                 return [2 /*return*/, Promise.resolve({ error: "404.not-found" })];
                             }
                         }
-                        return [4 /*yield*/, Fetch_1.Fetch.get("/study/" + studyId + "/activity?ignore_binary=" + ignore_binary, this.configuration)];
-                    case 1: return [2 /*return*/, (_b = (_c.sent()).data) === null || _b === void 0 ? void 0 : _b.map(function (x) { return Object.assign(new Activity_1.Activity(), x); })];
+                        params = new URLSearchParams();
+                        params.append('ignore_binary', String(ignore_binary));
+                        if (limit !== undefined && limit !== null) {
+                            params.append('limit', limit.toString());
+                        }
+                        if (offset !== undefined && offset !== null) {
+                            params.append('offset', offset.toString());
+                        }
+                        queryString = params.toString();
+                        return [4 /*yield*/, Fetch_1.Fetch.get("/study/" + studyId + "/activity?" + queryString, this.configuration)
+                            // Handle the response structure based on _select function behavior:
+                            // - With pagination (limit > 0 OR offset >= 0): { data: Activity[], total: number }
+                            // - Without pagination: { data: Activity[] } (total property is missing)
+                        ];
+                    case 1:
+                        result = _b.sent();
+                        activitiesArray = [];
+                        totalCount = 0;
+                        if (result && result.data && Array.isArray(result.data)) {
+                            activitiesArray = result.data;
+                            totalCount = typeof result.total === 'number' ? result.total : activitiesArray.length;
+                        }
+                        else if (Array.isArray(result)) {
+                            // Legacy fallback: if result is directly an array
+                            activitiesArray = result;
+                            totalCount = result.length;
+                        }
+                        mappedActivities = activitiesArray.map(function (x) { return Object.assign(new Activity_1.Activity(), x); });
+                        // If pagination was requested, return { data, total }, otherwise return array for backward compatibility
+                        if (typeof limit === 'number' && limit > 0 || typeof offset === 'number' && offset > 0) {
+                            return [2 /*return*/, { data: mappedActivities, total: totalCount }];
+                        }
+                        return [2 /*return*/, mappedActivities];
                 }
             });
         });

package/dist/service/ActivityEvent.service.d.ts

@@ -43,4 +43,15 @@ export declare class ActivityEventService {
      * @param to
      */
     delete(participantId: Identifier, origin?: string, from?: number, to?: number): Promise<Identifier>;
+    /**
+     * Get activities with events for a participant
+     * Returns array of { id: string, name: string, spec?: string }
+     * Excludes activities with specs: lamp.group, lamp.tips, lamp.module, lamp.zoom_meeting, lamp.fragmented_letters
+     * @param participantId
+     */
+    getActivitiesWithEvents(participantId: Identifier): Promise<Array<{
+        id: string;
+        name: string;
+        spec?: string;
+    }>>;
 }

package/dist/service/ActivityEvent.service.js

@@ -298,6 +298,32 @@ var ActivityEventService = /** @class */ (function () {
             });
         });
     };
+    /**
+     * Get activities with events for a participant
+     * Returns array of { id: string, name: string, spec?: string }
+     * Excludes activities with specs: lamp.group, lamp.tips, lamp.module, lamp.zoom_meeting, lamp.fragmented_letters
+     * @param participantId
+     */
+    ActivityEventService.prototype.getActivitiesWithEvents = function (participantId) {
+        return __awaiter(this, void 0, void 0, function () {
+            var result;
+            return __generator(this, function (_a) {
+                switch (_a.label) {
+                    case 0:
+                        if (participantId === null || participantId === undefined)
+                            throw new Error("Required parameter participantId was null or undefined when calling getActivitiesWithEvents.");
+                        if (this.configuration.base === "https://demo.lamp.digital") {
+                            // DEMO - return empty array for demo mode
+                            return [2 /*return*/, Promise.resolve([])];
+                        }
+                        return [4 /*yield*/, Fetch_1.Fetch.get("/participant/" + participantId + "/activity_event/activities", this.configuration)];
+                    case 1:
+                        result = _a.sent();
+                        return [2 /*return*/, result.data || []];
+                }
+            });
+        });
+    };
     return ActivityEventService;
 }());
 exports.ActivityEventService = ActivityEventService;

package/dist/service/Fetch.js

@@ -60,24 +60,37 @@ var handleSessionExpiry = function () { return __awaiter(void 0, void 0, void 0,
     });
 }); };
 //If access Token expired then call api for renewing the tokens
-var handleRenewToken = function (refreshToken, base) { return __awaiter(void 0, void 0, void 0, function () {
-    var credService, res, accessToken, error_1;
-    var _a, _b, _c;
-    return __generator(this, function (_d) {
-        switch (_d.label) {
+var handleRenewToken = function (refreshToken, base, configuration) { return __awaiter(void 0, void 0, void 0, function () {
+    var credService, res, accessToken, newRefreshToken, LAMP, identityObject, serverAddress, error_1;
+    var _a, _b, _c, _d, _e, _f;
+    return __generator(this, function (_g) {
+        switch (_g.label) {
             case 0:
-                _d.trys.push([0, 2, , 3]);
+                _g.trys.push([0, 2, , 3]);
                 credService = new Credential_service_1.CredentialService();
                 return [4 /*yield*/, credService.renewToken(refreshToken, base)];
             case 1:
-                res = _d.sent();
+                res = _g.sent();
                 accessToken = (_a = res === null || res === void 0 ? void 0 : res.data) === null || _a === void 0 ? void 0 : _a.access_token;
                 if (accessToken) {
-                    sessionStorage.setItem(userTokenKey, JSON.stringify({ accessToken: (_b = res === null || res === void 0 ? void 0 : res.data) === null || _b === void 0 ? void 0 : _b.access_token, refreshToken: (_c = res === null || res === void 0 ? void 0 : res.data) === null || _c === void 0 ? void 0 : _c.refresh_token }));
+                    newRefreshToken = ((_b = res === null || res === void 0 ? void 0 : res.data) === null || _b === void 0 ? void 0 : _b.refresh_token) || refreshToken;
+                    sessionStorage.setItem(userTokenKey, JSON.stringify({ accessToken: (_c = res === null || res === void 0 ? void 0 : res.data) === null || _c === void 0 ? void 0 : _c.access_token, refreshToken: newRefreshToken }));
+                    LAMP = global.LAMP || (typeof window !== "undefined" ? window.LAMP : null);
+                    if (LAMP && typeof LAMP.dispatchEvent === "function") {
+                        identityObject = ((_d = LAMP.Auth) === null || _d === void 0 ? void 0 : _d._me) || null;
+                        serverAddress = (configuration === null || configuration === void 0 ? void 0 : configuration.base) || base || ((_e = LAMP.configuration) === null || _e === void 0 ? void 0 : _e.base);
+                        LAMP.dispatchEvent("renewToken", {
+                            authorizationToken: (configuration === null || configuration === void 0 ? void 0 : configuration.authorization) || ((_f = LAMP.configuration) === null || _f === void 0 ? void 0 : _f.authorization),
+                            identityObject: identityObject,
+                            serverAddress: serverAddress,
+                            accessToken: accessToken,
+                            refreshToken: newRefreshToken,
+                        });
+                    }
                 }
                 return [2 /*return*/, accessToken];
             case 2:
-                error_1 = _d.sent();
+                error_1 = _g.sent();
                 console.log(error_1);
                 return [3 /*break*/, 3];
             case 3: return [2 /*return*/];
@@ -103,7 +116,7 @@ function _fetch(method, route, configuration, body) {
                     return [4 /*yield*/, fetch("" + configuration.base + route, {
                             method: method,
                             headers: new Headers(typeof authorization !== "undefined" && !!authorization
-                                ? __assign(__assign({ "Content-Type": "application/json", Accept: "application/json" }, (configuration.headers || {})), { Authorization: authorization }) : __assign({ "Content-Type": "application/json", Accept: "application/json" }, (configuration.headers || {}))),
+                                ? __assign(__assign({ "Content-Type": "application/json", "Access-Control-Allow-Origin": "*", Accept: "application/json" }, (configuration.headers || {})), { Authorization: authorization }) : __assign({ "Content-Type": "application/json", "Access-Control-Allow-Origin": "*", Accept: "application/json" }, (configuration.headers || {}))),
                             credentials: "include",
                             body: body !== undefined ? JSON.stringify(body) : undefined,
                         })];
@@ -129,7 +142,7 @@ function _fetch(method, route, configuration, body) {
                         handleSessionExpiry();
                         return [2 /*return*/, { data: [], error: "401.invalid-token" }];
                     }
-                    return [4 /*yield*/, handleRenewToken(refreshToken, configuration.base)];
+                    return [4 /*yield*/, handleRenewToken(refreshToken, configuration.base, configuration)];
                 case 5:
                     token = _d.sent();
                     if (!token) return [3 /*break*/, 17];

package/dist/service/ImageUpload.service.d.ts

@@ -0,0 +1,14 @@
+import { Configuration } from "./Fetch";
+export declare class ImageUploadService {
+    configuration?: Configuration;
+    /**
+     * Upload an image file to Azure Blob Storage
+     * @param imageType - Type of image: "tip_images", "survey_question_icons", or "activity_images"
+     * @param file - The image file to upload
+     * @returns Promise with originalUrl and thumbnailUrl
+     */
+    uploadImage(imageType: "tip_images" | "survey_question_icons" | "activity_images", file: File): Promise<{
+        originalUrl: string;
+        thumbnailUrl: string;
+    }>;
+}

package/dist/service/ImageUpload.service.js

@@ -0,0 +1,108 @@
+"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 __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 };
+    }
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ImageUploadService = void 0;
+var ImageUploadService = /** @class */ (function () {
+    function ImageUploadService() {
+    }
+    /**
+     * Upload an image file to Azure Blob Storage
+     * @param imageType - Type of image: "tip_images", "survey_question_icons", or "activity_images"
+     * @param file - The image file to upload
+     * @returns Promise with originalUrl and thumbnailUrl
+     */
+    ImageUploadService.prototype.uploadImage = function (imageType, file) {
+        return __awaiter(this, void 0, void 0, function () {
+            var formData, authorization, userTokenFromLocalStore, headers, response, error, result;
+            return __generator(this, function (_a) {
+                switch (_a.label) {
+                    case 0:
+                        if (!file) {
+                            throw new Error("File is required for image upload");
+                        }
+                        if (!["tip_images", "survey_question_icons", "activity_images"].includes(imageType)) {
+                            throw new Error("Invalid image type. Must be one of: tip_images, survey_question_icons, activity_images");
+                        }
+                        if (!this.configuration) {
+                            throw new Error("Cannot make HTTP request due to invalid configuration.");
+                        }
+                        formData = new FormData();
+                        formData.append("image", file);
+                        userTokenFromLocalStore = JSON.parse(sessionStorage.getItem("tokenInfo") || "null");
+                        if (userTokenFromLocalStore === null || userTokenFromLocalStore === void 0 ? void 0 : userTokenFromLocalStore.accessToken) {
+                            authorization = "Bearer " + (this.configuration.accessToken ? this.configuration.accessToken : userTokenFromLocalStore === null || userTokenFromLocalStore === void 0 ? void 0 : userTokenFromLocalStore.accessToken);
+                        }
+                        headers = __assign({ "Access-Control-Allow-Origin": "*", Accept: "application/json" }, (this.configuration.headers || {}));
+                        if (authorization) {
+                            headers.Authorization = authorization;
+                        }
+                        return [4 /*yield*/, fetch(this.configuration.base + "/upload/image/" + imageType, {
+                                method: "POST",
+                                headers: headers,
+                                credentials: "include",
+                                body: formData,
+                            })];
+                    case 1:
+                        response = _a.sent();
+                        if (!!response.ok) return [3 /*break*/, 3];
+                        return [4 /*yield*/, response.json().catch(function () { return ({ error: "HTTP " + response.status }); })];
+                    case 2:
+                        error = _a.sent();
+                        throw new Error(error.error || "Upload failed with status " + response.status);
+                    case 3: return [4 /*yield*/, response.json()];
+                    case 4:
+                        result = _a.sent();
+                        return [2 /*return*/, result.data || result];
+                }
+            });
+        });
+    };
+    return ImageUploadService;
+}());
+exports.ImageUploadService = ImageUploadService;

package/dist/service/Researcher.service.d.ts

@@ -31,4 +31,66 @@ export declare class ResearcherService {
     usersList(id: string, filters: any): Promise<any>;
     activitiesList(id: string, filters: any): Promise<any>;
     sensorsList(id: string, filters: any): Promise<any>;
+    /**
+     * Create an activity export job.
+     * @param researcherId
+     * @param body - { studyIds: string[], specs?: string[], format?: "json" | "ndjson" }
+     */
+    createActivityExport(researcherId: Identifier, body: {
+        studyIds: string[];
+        specs?: string[];
+        format?: "json" | "ndjson";
+    }): Promise<{
+        jobId: string;
+        status: string;
+    }>;
+    /**
+     * Get activity export job status.
+     * @param jobId
+     */
+    getActivityExportJob(jobId: string): Promise<any>;
+    /**
+     * Get activity export download URL.
+     * @param jobId
+     * @param ttl - Time to live in seconds (default: 600)
+     */
+    getActivityExportDownloadUrl(jobId: string, ttl?: number): Promise<{
+        url: string;
+        expiresIn: number;
+        contentType: string;
+        contentLength: number;
+    }>;
+    /**
+     * Create an activity import job.
+     * @param researcherId
+     * @param body - { studyId: string, format?: "json" | "ndjson" }
+     */
+    createActivityImport(researcherId: Identifier, body: {
+        studyId: string;
+        format?: "json" | "ndjson";
+    }): Promise<{
+        jobId: string;
+        status: string;
+    }>;
+    /**
+     * Get activity import job status.
+     * @param jobId
+     */
+    getActivityImportJob(jobId: string): Promise<any>;
+    /**
+     * Get activity import upload URL.
+     * @param jobId
+     * @param ttl - Time to live in seconds (default: 600)
+     */
+    getActivityImportUploadUrl(jobId: string, ttl?: number): Promise<{
+        url: string;
+        expiresIn: number;
+        blobName: string;
+    }>;
+    /**
+     * Complete activity import upload and trigger processing.
+     * @param jobId
+     * @param blobName
+     */
+    completeActivityImportUpload(jobId: string, blobName: string): Promise<any>;
 }