lamp-core-lst 2025.12.1 → 2026.1.1-4.2

package/dist/index.d.ts

@@ -45,6 +45,15 @@ export default class LAMP {
         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;

package/dist/index.js

@@ -131,7 +131,7 @@ var LAMP = /** @class */ (function () {
     //
     // [Credential/Identity Management]
     //
-    // Shorthand for console/data analysis usage.
+    // Shorthand for console/data analysis usage with Basic auth (accessKey:secretKey).
     LAMP.connect = function (identity) {
         if (identity === void 0) { identity = {
             accessKey: null,
@@ -157,6 +157,38 @@ var LAMP = /** @class */ (function () {
             });
         });
     };
+    /**
+     * 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
+     */
+    LAMP.connectWithToken = function (options) {
+        return __awaiter(this, void 0, void 0, function () {
+            return __generator(this, function (_a) {
+                if (!options.accessToken) {
+                    throw new Error("accessToken is required for Bearer token authentication");
+                }
+                if (!options.serverAddress) {
+                    throw new Error("serverAddress is required");
+                }
+                // Store auth info
+                LAMP.Auth._auth = {
+                    id: null,
+                    password: null,
+                    serverAddress: options.serverAddress,
+                    token: options.accessToken,
+                };
+                // Configure with Bearer token
+                LAMP.configuration = {
+                    base: options.serverAddress.startsWith("http")
+                        ? options.serverAddress
+                        : "https://" + options.serverAddress,
+                    accessToken: options.accessToken,
+                };
+                return [2 /*return*/];
+            });
+        });
+    };
     var _b;
     LAMP.API = new index_1.APIService();
     LAMP.Type = new index_1.TypeService();

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

@@ -105,4 +105,87 @@ export declare class ActivityService {
      * @param dateMs optional UTC ms for the day to fetch; defaults to today if omitted
      */
     feedDetails(participantId: Identifier, dateMs?: string): Promise<any>;
+    /**
+     * Get multiple activities in a single request (bulk fetch).
+     * More efficient than calling view() in a loop.
+     * @param activityIds Array of activity IDs to fetch
+     * @returns Array of Activity objects
+     */
+    viewBatch(activityIds: string[]): Promise<Activity[]>;
+    /**
+     * Export activities with their attachments.
+     * Fetches activities and their associated attachment data (activity_details or survey_description).
+     * @param activityIds Array of activity IDs to export
+     * @returns Array of { activity, attachment } objects
+     */
+    exportActivities(activityIds: string[]): Promise<ActivityExportResult[]>;
+    /**
+     * Import activities with their attachments into a target study.
+     * Creates new activities and sets their attachments.
+     * @param studyId Target study ID to import activities into
+     * @param activitiesWithAttachments Array of { activity, attachment } objects (from export)
+     * @param options Import options
+     * @returns Import result with success/failure details
+     */
+    importActivities(studyId: Identifier, activitiesWithAttachments: ActivityExportResult[], options?: ActivityImportOptions): Promise<ActivityImportResult>;
+    /**
+     * Delete an Activity bin.
+     * @param parentId Study ID for global delete, Activity ID for local delete
+     * @param binId
+     */
+    deleteActivityBin(parentId: Identifier, binId: Identifier, isGlobalDelete?: boolean, isEdit?: boolean): Promise<Identifier>;
+}
+/**
+ * Result of activity export
+ */
+export interface ActivityExportResult {
+    /** The exported activity */
+    activity: Activity;
+    /** The activity's attachment data (activity_details or survey_description) */
+    attachment: any | null;
+}
+/**
+ * Options for activity import
+ */
+export interface ActivityImportOptions {
+    /** Whether to preserve the original activity name (default: true) */
+    preserveName?: boolean;
+    /** Suffix to add to activity names */
+    nameSuffix?: string;
+    /** Prefix to add to activity names */
+    namePrefix?: string;
+    /** Whether to clear schedules during import (default: false) */
+    clearSchedule?: boolean;
+    /** Whether to preserve activity photo (default: false) */
+    preservePhoto?: boolean;
+}
+/**
+ * Result of a single activity import
+ */
+export interface ActivityImportResultItem {
+    /** Original activity ID from export */
+    originalId: string;
+    /** New activity ID after import (null if failed) */
+    newId: string | null;
+    /** Whether import was successful */
+    success: boolean;
+    /** Error message if failed */
+    error?: string;
+}
+/**
+ * Result of bulk import operation
+ */
+export interface ActivityImportResult {
+    /** Overall success (true if all imports succeeded) */
+    success: boolean;
+    /** Validation errors if data was invalid */
+    validationErrors: string[];
+    /** Individual import results */
+    results: ActivityImportResultItem[];
+    /** Summary statistics */
+    summary: {
+        total: number;
+        successful: number;
+        failed: number;
+    };
 }

package/dist/service/Activity.service.js

@@ -111,9 +111,7 @@ var ActivityService = /** @class */ (function () {
                                 output = (_a = Demo_1.Demo.Activity.filter(function (x) { var _a; return (_a = Demo_1.Demo.Participant.filter(function (y) { return y["id"] === participantId; })) === null || _a === void 0 ? void 0 : _a.map(function (y) { return y["#parent"]; }).includes(x["#parent"]); })) === 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;
                                 total = output.length;
-                                paginatedOutput = limit !== undefined && offset !== undefined
-                                    ? output.slice(offset, offset + limit)
-                                    : output;
+                                paginatedOutput = limit !== undefined && offset !== undefined ? output.slice(offset, offset + limit) : output;
                                 return [2 /*return*/, Promise.resolve({ data: paginatedOutput, total: total })];
                             }
                             else {
@@ -121,12 +119,12 @@ var ActivityService = /** @class */ (function () {
                             }
                         }
                         params = new URLSearchParams();
-                        params.append('ignore_binary', String(ignore_binary));
+                        params.append("ignore_binary", String(ignore_binary));
                         if (limit !== undefined && limit !== null) {
-                            params.append('limit', limit.toString());
+                            params.append("limit", limit.toString());
                         }
                         if (offset !== undefined && offset !== null) {
-                            params.append('offset', offset.toString());
+                            params.append("offset", offset.toString());
                         }
                         queryString = params.toString();
                         return [4 /*yield*/, Fetch_1.Fetch.get("/participant/" + participantId + "/activity?" + queryString, this.configuration)
@@ -144,7 +142,7 @@ var ActivityService = /** @class */ (function () {
                             activitiesArray = result.data;
                             // total exists only when pagination was provided (limit > 0 OR offset >= 0)
                             // When no pagination, _select returns array, server wraps as { data: array } (no total)
-                            totalCount = typeof result.total === 'number' ? result.total : activitiesArray.length;
+                            totalCount = typeof result.total === "number" ? result.total : activitiesArray.length;
                         }
                         else if (Array.isArray(result)) {
                             // Legacy fallback: if result is directly an array (shouldn't happen with current server)
@@ -153,7 +151,7 @@ var ActivityService = /** @class */ (function () {
                         }
                         return [2 /*return*/, {
                                 data: activitiesArray.map(function (x) { return Object.assign(new Activity_1.Activity(), x); }),
-                                total: totalCount
+                                total: totalCount,
                             }];
                 }
             });
@@ -226,11 +224,9 @@ var ActivityService = /** @class */ (function () {
                                 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) {
+                                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;
+                                    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)];
@@ -240,12 +236,12 @@ var ActivityService = /** @class */ (function () {
                             }
                         }
                         params = new URLSearchParams();
-                        params.append('ignore_binary', String(ignore_binary));
+                        params.append("ignore_binary", String(ignore_binary));
                         if (limit !== undefined && limit !== null) {
-                            params.append('limit', limit.toString());
+                            params.append("limit", limit.toString());
                         }
                         if (offset !== undefined && offset !== null) {
-                            params.append('offset', offset.toString());
+                            params.append("offset", offset.toString());
                         }
                         queryString = params.toString();
                         return [4 /*yield*/, Fetch_1.Fetch.get("/study/" + studyId + "/activity?" + queryString, this.configuration)
@@ -259,7 +255,7 @@ var ActivityService = /** @class */ (function () {
                         totalCount = 0;
                         if (result && result.data && Array.isArray(result.data)) {
                             activitiesArray = result.data;
-                            totalCount = typeof result.total === 'number' ? result.total : activitiesArray.length;
+                            totalCount = typeof result.total === "number" ? result.total : activitiesArray.length;
                         }
                         else if (Array.isArray(result)) {
                             // Legacy fallback: if result is directly an array
@@ -268,7 +264,7 @@ var ActivityService = /** @class */ (function () {
                         }
                         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) {
+                        if ((typeof limit === "number" && limit > 0) || (typeof offset === "number" && offset > 0)) {
                             return [2 /*return*/, { data: mappedActivities, total: totalCount }];
                         }
                         return [2 /*return*/, mappedActivities];
@@ -310,18 +306,18 @@ var ActivityService = /** @class */ (function () {
                         params = new URLSearchParams();
                         if (tab)
                             params.append("tab", tab);
-                        if (typeof limit === 'number' && limit > 0)
+                        if (typeof limit === "number" && limit > 0)
                             params.append("limit", limit.toString());
-                        if (typeof offset === 'number' && offset > 0)
+                        if (typeof offset === "number" && offset > 0)
                             params.append("offset", offset.toString());
                         queryString = params.toString();
-                        return [4 /*yield*/, Fetch_1.Fetch.get("/activity/" + participantId + "/activity" + (queryString ? "?" + queryString : ''), this.configuration)
+                        return [4 /*yield*/, Fetch_1.Fetch.get("/activity/" + participantId + "/activity" + (queryString ? "?" + queryString : ""), this.configuration)
                             // Handle different response structures
                         ];
                     case 1:
                         result = _b.sent();
                         // Handle different response structures
-                        if (result && result.data !== undefined && typeof result.total === 'number') {
+                        if (result && result.data !== undefined && typeof result.total === "number") {
                             return [2 /*return*/, { data: result.data, total: result.total }];
                         }
                         // Legacy fallback: if result is directly the data object
@@ -536,15 +532,17 @@ var ActivityService = /** @class */ (function () {
                         }
                         params = new URLSearchParams();
                         if (startTime !== undefined && startTime !== null) {
-                            params.append('startTime', startTime.toString());
+                            params.append("startTime", startTime.toString());
                         }
                         if (endTime !== undefined && endTime !== null) {
-                            params.append('endTime', endTime.toString());
+                            params.append("endTime", endTime.toString());
                         }
                         queryString = params.toString();
-                        url = "/module/" + moduleId + "/" + participantId + (queryString ? "?" + queryString : '');
+                        url = "/module/" + moduleId + "/" + participantId + (queryString ? "?" + queryString : "");
                         return [4 /*yield*/, Fetch_1.Fetch.get(url, 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); })];
+                    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);
+                        })];
                 }
             });
         });
@@ -792,6 +790,215 @@ var ActivityService = /** @class */ (function () {
             });
         });
     };
+    /**
+     * Get multiple activities in a single request (bulk fetch).
+     * More efficient than calling view() in a loop.
+     * @param activityIds Array of activity IDs to fetch
+     * @returns Array of Activity objects
+     */
+    ActivityService.prototype.viewBatch = function (activityIds) {
+        return __awaiter(this, void 0, void 0, function () {
+            var auth_16, credential, activities, result;
+            return __generator(this, function (_a) {
+                switch (_a.label) {
+                    case 0:
+                        if (!activityIds || activityIds.length === 0) {
+                            return [2 /*return*/, []];
+                        }
+                        if (this.configuration.base === "https://demo.lamp.digital") {
+                            auth_16 = (this.configuration.authorization || ":").split(":");
+                            credential = Demo_1.Demo.Credential.filter(function (x) { return x["access_key"] === auth_16[0] && x["secret_key"] === auth_16[1]; });
+                            if (credential.length === 0)
+                                return [2 /*return*/, Promise.resolve({ error: "403.invalid-credentials" })];
+                            activities = Demo_1.Demo.Activity.filter(function (x) { return activityIds.includes(x["id"]); });
+                            return [2 /*return*/, activities.map(function (activity) { return Object.assign(new Activity_1.Activity(), activity); })];
+                        }
+                        return [4 /*yield*/, Fetch_1.Fetch.post("/activity/batch", activityIds, this.configuration)];
+                    case 1:
+                        result = _a.sent();
+                        return [2 /*return*/, (result.data || []).map(function (x) { return Object.assign(new Activity_1.Activity(), x); })];
+                }
+            });
+        });
+    };
+    /**
+     * Export activities with their attachments.
+     * Fetches activities and their associated attachment data (activity_details or survey_description).
+     * @param activityIds Array of activity IDs to export
+     * @returns Array of { activity, attachment } objects
+     */
+    ActivityService.prototype.exportActivities = function (activityIds) {
+        return __awaiter(this, void 0, void 0, function () {
+            var auth_17, credential, activities, result;
+            return __generator(this, function (_a) {
+                switch (_a.label) {
+                    case 0:
+                        if (!activityIds || activityIds.length === 0) {
+                            return [2 /*return*/, []];
+                        }
+                        if (this.configuration.base === "https://demo.lamp.digital") {
+                            auth_17 = (this.configuration.authorization || ":").split(":");
+                            credential = Demo_1.Demo.Credential.filter(function (x) { return x["access_key"] === auth_17[0] && x["secret_key"] === auth_17[1]; });
+                            if (credential.length === 0)
+                                return [2 /*return*/, Promise.resolve({ error: "403.invalid-credentials" })];
+                            activities = Demo_1.Demo.Activity.filter(function (x) { return activityIds.includes(x["id"]); });
+                            return [2 /*return*/, activities.map(function (activity) { return ({
+                                    activity: Object.assign(new Activity_1.Activity(), activity),
+                                    attachment: null,
+                                }); })];
+                        }
+                        return [4 /*yield*/, Fetch_1.Fetch.post("/activity/export", activityIds, this.configuration)];
+                    case 1:
+                        result = _a.sent();
+                        return [2 /*return*/, result.data || []];
+                }
+            });
+        });
+    };
+    /**
+     * Import activities with their attachments into a target study.
+     * Creates new activities and sets their attachments.
+     * @param studyId Target study ID to import activities into
+     * @param activitiesWithAttachments Array of { activity, attachment } objects (from export)
+     * @param options Import options
+     * @returns Import result with success/failure details
+     */
+    ActivityService.prototype.importActivities = function (studyId, activitiesWithAttachments, options) {
+        return __awaiter(this, void 0, void 0, function () {
+            var auth_18, credential, results, _i, activitiesWithAttachments_1, item, newId, name_1, result;
+            return __generator(this, function (_a) {
+                switch (_a.label) {
+                    case 0:
+                        if (studyId === null || studyId === undefined) {
+                            throw new Error("Required parameter studyId was null or undefined when calling importActivities.");
+                        }
+                        if (!activitiesWithAttachments || activitiesWithAttachments.length === 0) {
+                            return [2 /*return*/, {
+                                    success: true,
+                                    validationErrors: [],
+                                    results: [],
+                                    summary: { total: 0, successful: 0, failed: 0 },
+                                }];
+                        }
+                        if (this.configuration.base === "https://demo.lamp.digital") {
+                            auth_18 = (this.configuration.authorization || ":").split(":");
+                            credential = Demo_1.Demo.Credential.filter(function (x) { return x["access_key"] === auth_18[0] && x["secret_key"] === auth_18[1]; });
+                            if (credential.length === 0)
+                                return [2 /*return*/, Promise.resolve({ error: "403.invalid-credentials" })];
+                            if (studyId === "me")
+                                studyId = credential.length > 0 ? credential[0]["origin"] : studyId;
+                            results = [];
+                            for (_i = 0, activitiesWithAttachments_1 = activitiesWithAttachments; _i < activitiesWithAttachments_1.length; _i++) {
+                                item = activitiesWithAttachments_1[_i];
+                                newId = "activity" + Math.random().toString().substring(2, 6);
+                                name_1 = (options === null || options === void 0 ? void 0 : options.namePrefix) ? "" + options.namePrefix + item.activity.name
+                                    : (options === null || options === void 0 ? void 0 : options.nameSuffix) ? "" + item.activity.name + options.nameSuffix
+                                        : item.activity.name;
+                                Demo_1.Demo.Activity.push({
+                                    "#type": "Activity",
+                                    "#parent": studyId,
+                                    id: newId,
+                                    spec: item.activity.spec,
+                                    name: name_1,
+                                    settings: item.activity.settings,
+                                    schedule: (options === null || options === void 0 ? void 0 : options.clearSchedule) ? [] : item.activity.schedule,
+                                });
+                                results.push({
+                                    originalId: item.activity.id,
+                                    newId: newId,
+                                    success: true,
+                                });
+                            }
+                            return [2 /*return*/, {
+                                    success: true,
+                                    validationErrors: [],
+                                    results: results,
+                                    summary: {
+                                        total: results.length,
+                                        successful: results.length,
+                                        failed: 0,
+                                    },
+                                }];
+                        }
+                        return [4 /*yield*/, Fetch_1.Fetch.post("/study/" + studyId + "/activity/import", { activities: activitiesWithAttachments, options: options }, this.configuration)];
+                    case 1:
+                        result = _a.sent();
+                        return [2 /*return*/, (result.data || {
+                                success: false,
+                                validationErrors: [],
+                                results: [],
+                                summary: { total: 0, successful: 0, failed: 0 },
+                            })];
+                }
+            });
+        });
+    };
+    /**
+     * Delete an Activity bin.
+     * @param parentId Study ID for global delete, Activity ID for local delete
+     * @param binId
+     */
+    ActivityService.prototype.deleteActivityBin = function (parentId, binId, isGlobalDelete, isEdit) {
+        if (isGlobalDelete === void 0) { isGlobalDelete = false; }
+        if (isEdit === void 0) { isEdit = false; }
+        return __awaiter(this, void 0, void 0, function () {
+            var auth_19, credential, binIdx, activityIdx, binIdx, params, queryString, route;
+            return __generator(this, function (_a) {
+                switch (_a.label) {
+                    case 0:
+                        if (parentId === null || parentId === undefined)
+                            throw new Error("Required parameter parentId was null or undefined.");
+                        if (binId === null || binId === undefined)
+                            throw new Error("Required parameter binId was null or undefined.");
+                        if (this.configuration.base === "https://demo.lamp.digital") {
+                            auth_19 = (this.configuration.authorization || ":").split(":");
+                            credential = Demo_1.Demo.Credential.filter(function (x) { return x["access_key"] === auth_19[0] && x["secret_key"] === auth_19[1]; });
+                            if (credential.length === 0)
+                                return [2 /*return*/, Promise.resolve({ error: "403.invalid-credentials" })];
+                            if (parentId === "me")
+                                parentId = credential.length > 0 ? credential[0]["origin"] : parentId;
+                            if (isGlobalDelete) {
+                                binIdx = Demo_1.Demo.ActivityBin.findIndex(function (x) { return x["id"] === binId; });
+                                if (binIdx >= 0) {
+                                    Demo_1.Demo.ActivityBin.splice(binIdx, 1);
+                                    return [2 /*return*/, Promise.resolve({})];
+                                }
+                                else {
+                                    return [2 /*return*/, Promise.resolve({ error: "404.not-found" })];
+                                }
+                            }
+                            else {
+                                activityIdx = Demo_1.Demo.Activity.findIndex(function (x) { return x["id"] === parentId; });
+                                if (activityIdx < 0) {
+                                    return [2 /*return*/, Promise.resolve({ error: "404.not-found" })];
+                                }
+                                binIdx = Demo_1.Demo.ActivityBin.findIndex(function (x) { return x["id"] === binId && x["activity"] === parentId; });
+                                if (binIdx >= 0) {
+                                    Demo_1.Demo.ActivityBin.splice(binIdx, 1);
+                                    return [2 /*return*/, Promise.resolve({})];
+                                }
+                                else {
+                                    return [2 /*return*/, Promise.resolve({ error: "404.not-found" })];
+                                }
+                            }
+                        }
+                        params = new URLSearchParams();
+                        if (isGlobalDelete) {
+                            params.append("isGlobalDelete", String(isGlobalDelete));
+                        }
+                        if (isEdit) {
+                            params.append("isEdit", String(isEdit));
+                        }
+                        queryString = params.toString();
+                        route = queryString
+                            ? "/activity/bin/" + parentId + "/" + binId + "?" + queryString
+                            : "/activity/bin/" + parentId + "/" + binId;
+                        return [4 /*yield*/, Fetch_1.Fetch.delete(route, this.configuration)];
+                    case 1: return [2 /*return*/, _a.sent()];
+                }
+            });
+        });
+    };
     return ActivityService;
 }());
 exports.ActivityService = ActivityService;

package/dist/service/Demo.d.ts

@@ -6,6 +6,7 @@ export declare let Demo: {
     Study: any[];
     Participant: any[];
     Activity: any[];
+    ActivityBin: any[];
     Sensor: any[];
     ActivityEvent: any[];
     SensorEvent: any[];

package/dist/service/Demo.js

@@ -16,6 +16,7 @@ exports.Demo = {
     Study: [],
     Participant: [],
     Activity: [],
+    ActivityBin: [],
     Sensor: [],
     ActivityEvent: [],
     SensorEvent: [],