lamp-core-lst 2025.11.20 → 2025.12.0-1.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/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/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*/];
@@ -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/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>;
 }

package/dist/service/Researcher.service.js

@@ -247,6 +247,216 @@ var ResearcherService = /** @class */ (function () {
             });
         });
     };
+    /**
+     * Create an activity export job.
+     * @param researcherId
+     * @param body - { studyIds: string[], specs?: string[], format?: "json" | "ndjson" }
+     */
+    ResearcherService.prototype.createActivityExport = function (researcherId, body) {
+        return __awaiter(this, void 0, void 0, function () {
+            var result;
+            return __generator(this, function (_a) {
+                switch (_a.label) {
+                    case 0:
+                        if (researcherId === null || researcherId === undefined)
+                            throw new Error("Required parameter researcherId was null or undefined when calling createActivityExport.");
+                        if (this.configuration.base === "https://demo.lamp.digital") {
+                            return [2 /*return*/, Promise.resolve({ error: "500.demo-restriction" })];
+                        }
+                        return [4 /*yield*/, Fetch_1.Fetch.post("/researcher/" + researcherId + "/activity-export", body, this.configuration)];
+                    case 1:
+                        result = _a.sent();
+                        if (result.error) {
+                            throw new Error(result.error);
+                        }
+                        if (!result.data) {
+                            throw new Error("Invalid response from export API");
+                        }
+                        return [2 /*return*/, result.data];
+                }
+            });
+        });
+    };
+    /**
+     * Get activity export job status.
+     * @param jobId
+     */
+    ResearcherService.prototype.getActivityExportJob = function (jobId) {
+        return __awaiter(this, void 0, void 0, function () {
+            var result;
+            return __generator(this, function (_a) {
+                switch (_a.label) {
+                    case 0:
+                        if (jobId === null || jobId === undefined)
+                            throw new Error("Required parameter jobId was null or undefined when calling getActivityExportJob.");
+                        if (this.configuration.base === "https://demo.lamp.digital") {
+                            return [2 /*return*/, Promise.resolve({ error: "500.demo-restriction" })];
+                        }
+                        return [4 /*yield*/, Fetch_1.Fetch.get("/exports/" + jobId, this.configuration)];
+                    case 1:
+                        result = _a.sent();
+                        if (result.error) {
+                            throw new Error(result.error);
+                        }
+                        if (!result.data) {
+                            throw new Error("Invalid response from export job API");
+                        }
+                        return [2 /*return*/, result.data];
+                }
+            });
+        });
+    };
+    /**
+     * Get activity export download URL.
+     * @param jobId
+     * @param ttl - Time to live in seconds (default: 600)
+     */
+    ResearcherService.prototype.getActivityExportDownloadUrl = function (jobId, ttl) {
+        if (ttl === void 0) { ttl = 600; }
+        return __awaiter(this, void 0, void 0, function () {
+            var result;
+            return __generator(this, function (_a) {
+                switch (_a.label) {
+                    case 0:
+                        if (jobId === null || jobId === undefined)
+                            throw new Error("Required parameter jobId was null or undefined when calling getActivityExportDownloadUrl.");
+                        if (this.configuration.base === "https://demo.lamp.digital") {
+                            return [2 /*return*/, Promise.resolve({ error: "500.demo-restriction" })];
+                        }
+                        return [4 /*yield*/, Fetch_1.Fetch.get("/exports/" + jobId + "/download?ttl=" + ttl, this.configuration)];
+                    case 1:
+                        result = _a.sent();
+                        if (result.error) {
+                            throw new Error(result.error);
+                        }
+                        if (!result.data) {
+                            throw new Error("Invalid response from export download API");
+                        }
+                        return [2 /*return*/, result.data];
+                }
+            });
+        });
+    };
+    /**
+     * Create an activity import job.
+     * @param researcherId
+     * @param body - { studyId: string, format?: "json" | "ndjson" }
+     */
+    ResearcherService.prototype.createActivityImport = function (researcherId, body) {
+        return __awaiter(this, void 0, void 0, function () {
+            var result;
+            return __generator(this, function (_a) {
+                switch (_a.label) {
+                    case 0:
+                        if (researcherId === null || researcherId === undefined)
+                            throw new Error("Required parameter researcherId was null or undefined when calling createActivityImport.");
+                        if (this.configuration.base === "https://demo.lamp.digital") {
+                            return [2 /*return*/, Promise.resolve({ error: "500.demo-restriction" })];
+                        }
+                        return [4 /*yield*/, Fetch_1.Fetch.post("/researcher/" + researcherId + "/activity-import", body, this.configuration)];
+                    case 1:
+                        result = _a.sent();
+                        if (result.error) {
+                            throw new Error(result.error);
+                        }
+                        if (!result.data) {
+                            throw new Error("Invalid response from import API");
+                        }
+                        return [2 /*return*/, result.data];
+                }
+            });
+        });
+    };
+    /**
+     * Get activity import job status.
+     * @param jobId
+     */
+    ResearcherService.prototype.getActivityImportJob = function (jobId) {
+        return __awaiter(this, void 0, void 0, function () {
+            var result;
+            return __generator(this, function (_a) {
+                switch (_a.label) {
+                    case 0:
+                        if (jobId === null || jobId === undefined)
+                            throw new Error("Required parameter jobId was null or undefined when calling getActivityImportJob.");
+                        if (this.configuration.base === "https://demo.lamp.digital") {
+                            return [2 /*return*/, Promise.resolve({ error: "500.demo-restriction" })];
+                        }
+                        return [4 /*yield*/, Fetch_1.Fetch.get("/imports/" + jobId, this.configuration)];
+                    case 1:
+                        result = _a.sent();
+                        if (result.error) {
+                            throw new Error(result.error);
+                        }
+                        if (!result.data) {
+                            throw new Error("Invalid response from import job API");
+                        }
+                        return [2 /*return*/, result.data];
+                }
+            });
+        });
+    };
+    /**
+     * Get activity import upload URL.
+     * @param jobId
+     * @param ttl - Time to live in seconds (default: 600)
+     */
+    ResearcherService.prototype.getActivityImportUploadUrl = function (jobId, ttl) {
+        if (ttl === void 0) { ttl = 600; }
+        return __awaiter(this, void 0, void 0, function () {
+            var result;
+            return __generator(this, function (_a) {
+                switch (_a.label) {
+                    case 0:
+                        if (jobId === null || jobId === undefined)
+                            throw new Error("Required parameter jobId was null or undefined when calling getActivityImportUploadUrl.");
+                        if (this.configuration.base === "https://demo.lamp.digital") {
+                            return [2 /*return*/, Promise.resolve({ error: "500.demo-restriction" })];
+                        }
+                        return [4 /*yield*/, Fetch_1.Fetch.post("/imports/" + jobId + "/upload-url", { ttl: ttl }, this.configuration)];
+                    case 1:
+                        result = _a.sent();
+                        if (result.error) {
+                            throw new Error(result.error);
+                        }
+                        if (!result.data) {
+                            throw new Error("Invalid response from import upload URL API");
+                        }
+                        return [2 /*return*/, result.data];
+                }
+            });
+        });
+    };
+    /**
+     * Complete activity import upload and trigger processing.
+     * @param jobId
+     * @param blobName
+     */
+    ResearcherService.prototype.completeActivityImportUpload = function (jobId, blobName) {
+        return __awaiter(this, void 0, void 0, function () {
+            var result;
+            return __generator(this, function (_a) {
+                switch (_a.label) {
+                    case 0:
+                        if (jobId === null || jobId === undefined)
+                            throw new Error("Required parameter jobId was null or undefined when calling completeActivityImportUpload.");
+                        if (this.configuration.base === "https://demo.lamp.digital") {
+                            return [2 /*return*/, Promise.resolve({ error: "500.demo-restriction" })];
+                        }
+                        return [4 /*yield*/, Fetch_1.Fetch.post("/imports/" + jobId + "/complete-upload", { blobName: blobName }, this.configuration)];
+                    case 1:
+                        result = _a.sent();
+                        if (result.error) {
+                            throw new Error(result.error);
+                        }
+                        if (!result.data) {
+                            throw new Error("Invalid response from complete import upload API");
+                        }
+                        return [2 /*return*/, result.data];
+                }
+            });
+        });
+    };
     return ResearcherService;
 }());
 exports.ResearcherService = ResearcherService;

package/dist/service/ResearcherSettings.d.ts

@@ -0,0 +1,69 @@
+import { Timestamp } from "../model/Type";
+/**
+ *
+ */
+export declare class ResearcherSettings {
+    /**
+     * The banner greeting.
+     */
+    bannerSettings?: string;
+    /**
+     * The banner heading
+     */
+    bannerHeading?: string;
+    /**
+     * The banner sub heading
+     */
+    bannerSubHeading?: string;
+    /**
+     * The image icon for banner
+     */
+    imageBase64?: string;
+    /**
+     * The selected activity
+     */
+    selectedActivity?: string;
+    /**
+     * The selected group
+     */
+    selectedGroup?: string;
+    /**
+     * The button text
+     */
+    buttonText?: string;
+    /**
+     * The activityId
+     */
+    activityId?: string;
+    /**
+     * The favourite activities
+     */
+    favouriteActivities?: any;
+    /**
+     * The featured activity
+     */
+    featuredActivity?: string;
+    /**
+     * The streak type
+     */
+    streak?: string;
+    /**
+     * The Streak title
+     */
+    streakTitle?: string;
+    /**
+     * The Streak description
+     */
+    streakDesc?: string;
+    /**
+     * The timestamp
+     */
+    timestamp?: Timestamp;
+    /**
+     * The deleted flag
+     */
+    deleted?: boolean;
+}
+export declare type ResearcherBanner = {
+    data: ResearcherSettings;
+};

package/dist/service/ResearcherSettings.js

@@ -0,0 +1,12 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ResearcherSettings = void 0;
+/**
+ *
+ */
+var ResearcherSettings = /** @class */ (function () {
+    function ResearcherSettings() {
+    }
+    return ResearcherSettings;
+}());
+exports.ResearcherSettings = ResearcherSettings;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "lamp-core-lst",
-  "version": "2025.11.20",
+  "version": "2025.12.0-1.1",
   "author": "BIDMC Division of Digital Psychiatry <team@digitalpsych.org>",
   "description": "The JavaScript and TypeScript API client for the LAMP Platform.",
   "homepage": "https://docs.lamp.digital/",

package/src/model/Activity.ts

@@ -86,6 +86,11 @@ export class 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/src/service/Activity.service.ts

@@ -142,8 +142,18 @@ export 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
    */
-  public async allByStudy(studyId: Identifier, transform?: string, ignore_binary?: boolean): Promise<Activity[]> {
+  public async allByStudy(
+    studyId: Identifier, 
+    transform?: string, 
+    ignore_binary?: boolean,
+    limit?: number,
+    offset?: number
+  ): Promise<Activity[] | { data: Activity[], total: number }> {
     if (studyId === null || studyId === undefined)
       throw new Error("Required parameter studyId was null or undefined when calling activityAllByStudy.")
     if (ignore_binary === null || ignore_binary === undefined) ignore_binary = false
@@ -157,14 +167,58 @@ export class ActivityService {
       if (Demo.Study.filter((x) => x["id"] === studyId).length > 0) {
         let output = Demo.Activity.filter((x) => x["#parent"] === studyId)?.map((x) => Object.assign(new Activity(), x))
         output = typeof transform === "string" ? jsonata(transform).evaluate(output) : output
+        // If pagination is requested, return paginated result with total
+        if (typeof limit === 'number' && limit > 0 || typeof offset === 'number' && offset > 0) {
+          const total = output.length
+          const paginatedOutput = limit !== undefined && offset !== undefined
+            ? output.slice(offset, offset + limit)
+            : output
+          return Promise.resolve({ data: paginatedOutput, total })
+        }
         return Promise.resolve(output)
       } else {
         return Promise.resolve({ error: "404.not-found" } as any)
       }
     }
-    return (
-      await Fetch.get<{ data: any[] }>(`/study/${studyId}/activity?ignore_binary=${ignore_binary}`, this.configuration)
-    ).data?.map((x) => Object.assign(new Activity(), x))
+    
+    // Build query string with pagination parameters
+    const 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())
+    }
+    const queryString = params.toString()
+    
+    const result: any = await Fetch.get<{ data: Activity[], total?: number }>(
+      `/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)
+    let activitiesArray: any[] = []
+    let 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
+    }
+    
+    const mappedActivities = activitiesArray.map((x: any) => Object.assign(new 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 { data: mappedActivities, total: totalCount }
+    }
+    return mappedActivities
   }
   /**
    * Get the set of all activities available to  participants of a single study, by participant identifier.

package/src/service/Fetch.ts

@@ -38,7 +38,7 @@ const handleSessionExpiry = async () => {
 }
 
 //If access Token expired then call api for renewing the tokens
-const handleRenewToken = async (refreshToken: string, base: string) => {
+const handleRenewToken = async (refreshToken: string, base: string, configuration?: Configuration) => {
   try {
     const credService = new CredentialService()
     const res = await credService.renewToken(refreshToken, base)
@@ -46,10 +46,28 @@ const handleRenewToken = async (refreshToken: string, base: string) => {
     const accessToken = res?.data?.access_token
 
     if (accessToken) {
+      const newRefreshToken = res?.data?.refresh_token || refreshToken
       sessionStorage.setItem(
         userTokenKey,
-        JSON.stringify({ accessToken: res?.data?.access_token, refreshToken: res?.data?.refresh_token })
+        JSON.stringify({ accessToken: res?.data?.access_token, refreshToken: newRefreshToken })
       )
+      
+      // Dispatch renewToken event similar to LOGIN event
+      // Access LAMP from global scope to avoid circular dependency
+      const LAMP = (global as any).LAMP || (typeof window !== "undefined" ? (window as any).LAMP : null)
+      if (LAMP && typeof LAMP.dispatchEvent === "function") {
+        // Get identity object from LAMP.Auth if available
+        const identityObject = LAMP.Auth?._me || null
+        const serverAddress = configuration?.base || base || LAMP.configuration?.base
+        
+        LAMP.dispatchEvent("renewToken", {
+          authorizationToken: configuration?.authorization || LAMP.configuration?.authorization,
+          identityObject: identityObject,
+          serverAddress: serverAddress,
+          accessToken: accessToken,
+          refreshToken: newRefreshToken,
+        })
+      }
     }
     return accessToken
   } catch (error) {
@@ -93,7 +111,7 @@ async function _fetch<ResultType>(
               ...(configuration!.headers || {}),
             } as any)
       ),
-      credentials: "include",
+      credentials: "include",                                                           
       body: body !== undefined ? JSON.stringify(body) : undefined,
     })
     if (!response.ok) {
@@ -113,7 +131,7 @@ async function _fetch<ResultType>(
             handleSessionExpiry()
             return { data: [], error: "401.invalid-token" } as unknown as ResultType
           }
-          const token = await handleRenewToken(refreshToken, configuration.base)
+          const token = await handleRenewToken(refreshToken, configuration.base, configuration)
           if (token) {
             configuration.authorization = token
             // retry the same request

package/src/service/Researcher.service.ts

@@ -144,4 +144,173 @@ export class ResearcherService {
     const result = await Fetch.post(`/researcher/sensors/${id}`, filters, this.configuration) as any
     return result?.data
   }
-}
+
+  /**
+   * Create an activity export job.
+   * @param researcherId
+   * @param body - { studyIds: string[], specs?: string[], format?: "json" | "ndjson" }
+   */
+  public async createActivityExport(researcherId: Identifier, body: {
+    studyIds: string[]
+    specs?: string[]
+    format?: "json" | "ndjson"
+  }): Promise<{ jobId: string; status: string }> {
+    if (researcherId === null || researcherId === undefined)
+      throw new Error("Required parameter researcherId was null or undefined when calling createActivityExport.")
+    if (this.configuration.base === "https://demo.lamp.digital") {
+      return Promise.resolve({ error: "500.demo-restriction" } as any)
+    }
+    const result = await Fetch.post<{ data: { jobId: string; status: string }; error?: string }>(
+      `/researcher/${researcherId}/activity-export`,
+      body,
+      this.configuration
+    )
+    if (result.error) {
+      throw new Error(result.error)
+    }
+    if (!result.data) {
+      throw new Error("Invalid response from export API")
+    }
+    return result.data
+  }
+
+  /**
+   * Get activity export job status.
+   * @param jobId
+   */
+  public async getActivityExportJob(jobId: string): Promise<any> {
+    if (jobId === null || jobId === undefined)
+      throw new Error("Required parameter jobId was null or undefined when calling getActivityExportJob.")
+    if (this.configuration.base === "https://demo.lamp.digital") {
+      return Promise.resolve({ error: "500.demo-restriction" } as any)
+    }
+    const result = await Fetch.get<{ data: any; error?: string }>(`/exports/${jobId}`, this.configuration)
+    if (result.error) {
+      throw new Error(result.error)
+    }
+    if (!result.data) {
+      throw new Error("Invalid response from export job API")
+    }
+    return result.data
+  }
+
+  /**
+   * Get activity export download URL.
+   * @param jobId
+   * @param ttl - Time to live in seconds (default: 600)
+   */
+  public async getActivityExportDownloadUrl(jobId: string, ttl: number = 600): Promise<{
+    url: string
+    expiresIn: number
+    contentType: string
+    contentLength: number
+  }> {
+    if (jobId === null || jobId === undefined)
+      throw new Error("Required parameter jobId was null or undefined when calling getActivityExportDownloadUrl.")
+    if (this.configuration.base === "https://demo.lamp.digital") {
+      return Promise.resolve({ error: "500.demo-restriction" } as any)
+    }
+    const result = await Fetch.get<{ data: any; error?: string }>(`/exports/${jobId}/download?ttl=${ttl}`, this.configuration)
+    if (result.error) {
+      throw new Error(result.error)
+    }
+    if (!result.data) {
+      throw new Error("Invalid response from export download API")
+    }
+    return result.data
+  }
+
+  /**
+   * Create an activity import job.
+   * @param researcherId
+   * @param body - { studyId: string, format?: "json" | "ndjson" }
+   */
+  public async createActivityImport(researcherId: Identifier, body: {
+    studyId: string
+    format?: "json" | "ndjson"
+  }): Promise<{ jobId: string; status: string }> {
+    if (researcherId === null || researcherId === undefined)
+      throw new Error("Required parameter researcherId was null or undefined when calling createActivityImport.")
+    if (this.configuration.base === "https://demo.lamp.digital") {
+      return Promise.resolve({ error: "500.demo-restriction" } as any)
+    }
+    const result = await Fetch.post<{ data: { jobId: string; status: string }; error?: string }>(
+      `/researcher/${researcherId}/activity-import`,
+      body,
+      this.configuration
+    )
+    if (result.error) {
+      throw new Error(result.error)
+    }
+    if (!result.data) {
+      throw new Error("Invalid response from import API")
+    }
+    return result.data
+  }
+
+  /**
+   * Get activity import job status.
+   * @param jobId
+   */
+  public async getActivityImportJob(jobId: string): Promise<any> {
+    if (jobId === null || jobId === undefined)
+      throw new Error("Required parameter jobId was null or undefined when calling getActivityImportJob.")
+    if (this.configuration.base === "https://demo.lamp.digital") {
+      return Promise.resolve({ error: "500.demo-restriction" } as any)
+    }
+    const result = await Fetch.get<{ data: any; error?: string }>(`/imports/${jobId}`, this.configuration)
+    if (result.error) {
+      throw new Error(result.error)
+    }
+    if (!result.data) {
+      throw new Error("Invalid response from import job API")
+    }
+    return result.data
+  }
+
+  /**
+   * Get activity import upload URL.
+   * @param jobId
+   * @param ttl - Time to live in seconds (default: 600)
+   */
+  public async getActivityImportUploadUrl(jobId: string, ttl: number = 600): Promise<{
+    url: string
+    expiresIn: number
+    blobName: string
+  }> {
+    if (jobId === null || jobId === undefined)
+      throw new Error("Required parameter jobId was null or undefined when calling getActivityImportUploadUrl.")
+    if (this.configuration.base === "https://demo.lamp.digital") {
+      return Promise.resolve({ error: "500.demo-restriction" } as any)
+    }
+    const result = await Fetch.post<{ data: any; error?: string }>(`/imports/${jobId}/upload-url`, { ttl }, this.configuration)
+    if (result.error) {
+      throw new Error(result.error)
+    }
+    if (!result.data) {
+      throw new Error("Invalid response from import upload URL API")
+    }
+    return result.data
+  }
+
+  /**
+   * Complete activity import upload and trigger processing.
+   * @param jobId
+   * @param blobName
+   */
+  public async completeActivityImportUpload(jobId: string, blobName: string): Promise<any> {
+    if (jobId === null || jobId === undefined)
+      throw new Error("Required parameter jobId was null or undefined when calling completeActivityImportUpload.")
+    if (this.configuration.base === "https://demo.lamp.digital") {
+      return Promise.resolve({ error: "500.demo-restriction" } as any)
+    }
+    const result = await Fetch.post<{ data: any; error?: string }>(`/imports/${jobId}/complete-upload`, { blobName }, this.configuration)
+    if (result.error) {
+      throw new Error(result.error)
+    }
+    if (!result.data) {
+      throw new Error("Invalid response from complete import upload API")
+    }
+    return result.data
+  }
+}

package/src/service/ResearcherSettings.ts

@@ -0,0 +1,77 @@
+import { Identifier, Timestamp } from "../model/Type"
+
+/**
+ *
+ */
+export class ResearcherSettings {
+  /**
+   * The banner greeting.
+   */
+  bannerSettings?: string
+
+  /**
+   * The banner heading
+   */
+  bannerHeading?: string
+
+  /**
+   * The banner sub heading
+   */
+  bannerSubHeading?: string
+
+  /**
+   * The image icon for banner
+   */
+  imageBase64?: string
+
+  /**
+   * The selected activity
+   */
+  selectedActivity?: string
+
+  /**
+   * The selected group
+   */
+  selectedGroup?: string
+  /**
+   * The button text
+   */
+  buttonText?: string
+  /**
+   * The activityId
+   */
+  activityId?: string
+  /**
+   * The favourite activities
+   */
+  favouriteActivities?: any
+  /**
+   * The featured activity
+   */
+  featuredActivity?: string
+  /**
+   * The streak type
+   */
+  streak?: string
+  /**
+   * The Streak title
+   */
+  streakTitle?: string
+  /**
+   * The Streak description
+   */
+  streakDesc?: string
+  /**
+   * The timestamp
+   */
+  timestamp?: Timestamp
+
+  /**
+   * The deleted flag
+   */
+  deleted?: boolean
+}
+
+export type ResearcherBanner = {
+  data: ResearcherSettings
+}