lamp-core-lst 2026.1.1-4.2 → 2026.1.19

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, ImageUploadService } from "./service/index";
+import { APIService, ActivityService, ActivityEventService, ActivitySpecService, CredentialService, ParticipantService, ResearcherService, SensorService, SensorEventService, SensorSpecService, StudyService, TypeService, ResearcherSettingsService, ImageUploadService, SurveyResponseService } from "./service/index";
 export * from "./service/index";
 export * from "./model/index";
 /**
@@ -30,6 +30,7 @@ export default class LAMP {
     static SensorSpec: SensorSpecService;
     static ResearcherSettings: ResearcherSettingsService;
     static ImageUpload: ImageUploadService;
+    static SurveyResponse: SurveyResponseService;
     private static get configuration();
     private static set configuration(value);
     private static protocol;

package/dist/index.js

@@ -91,6 +91,7 @@ var LAMP = /** @class */ (function () {
             LAMP.Type.configuration = configuration;
             LAMP.ResearcherSettings.configuration = configuration;
             LAMP.ImageUpload.configuration = configuration;
+            LAMP.SurveyResponse.configuration = configuration;
         },
         enumerable: false,
         configurable: true
@@ -204,6 +205,7 @@ var LAMP = /** @class */ (function () {
     LAMP.SensorSpec = new index_1.SensorSpecService();
     LAMP.ResearcherSettings = new index_1.ResearcherSettingsService();
     LAMP.ImageUpload = new index_1.ImageUploadService();
+    LAMP.SurveyResponse = new index_1.SurveyResponseService();
     LAMP.protocol = "https://";
     LAMP.Auth = (_b = /** @class */ (function () {
             function class_1() {

package/dist/service/SurveyResponse.service.d.ts

@@ -0,0 +1,142 @@
+import { Configuration } from "./Fetch";
+import { Identifier } from "../model/Type";
+export interface SurveyResponse {
+    date: number;
+    timestamp: number;
+    firstAnswer: any;
+    isPinned?: boolean;
+}
+export interface SurveyItem {
+    id: string;
+    title: string;
+    binName?: string;
+    responses: SurveyResponse[];
+}
+export interface SurveyGroup {
+    id: string;
+    label: string;
+    surveys: SurveyItem[];
+}
+export interface GroupedSurveyResponse {
+    groups: SurveyGroup[];
+    ungroupedSurveys: SurveyItem[];
+}
+export declare type FilterType = "weekly" | "daily" | "monthly" | "all" | "pinned";
+export interface FilterParams {
+    filterType: FilterType;
+    date?: number;
+    fromDate?: number;
+    toDate?: number;
+    month?: number;
+    year?: number;
+}
+export interface PinSurveyResponseParams {
+    activity_id: string;
+    timestamp: number;
+}
+export interface PinSurveyResponseResult {
+    success: boolean;
+    message: string;
+}
+export declare class SurveyResponseService {
+    configuration?: Configuration;
+    /**
+     * Get survey responses for a participant grouped by survey groups from researcher settings
+     * @param participantId - The participant ID
+     * @param filterParams - Filter parameters for the query
+     * @returns Promise<GroupedSurveyResponse>
+     *
+     * @example
+     * // Get weekly responses (last 7 days)
+     * const result = await LAMP.SurveyResponse.getSurveyResponses('participant_id', { filterType: 'weekly' });
+     *
+     * @example
+     * // Get weekly responses with custom date range
+     * const result = await LAMP.SurveyResponse.getSurveyResponses('participant_id', {
+     *   filterType: 'weekly',
+     *   fromDate: 1700000000000,
+     *   toDate: 1700604800000
+     * });
+     *
+     * @example
+     * // Get daily responses for a specific date
+     * const result = await LAMP.SurveyResponse.getSurveyResponses('participant_id', {
+     *   filterType: 'daily',
+     *   date: 1700000000000
+     * });
+     *
+     * @example
+     * // Get monthly responses
+     * const result = await LAMP.SurveyResponse.getSurveyResponses('participant_id', {
+     *   filterType: 'monthly',
+     *   month: 12,
+     *   year: 2025
+     * });
+     *
+     * @example
+     * // Get all responses
+     * const result = await LAMP.SurveyResponse.getSurveyResponses('participant_id', { filterType: 'all' });
+     *
+     * @example
+     * // Get pinned responses only
+     * const result = await LAMP.SurveyResponse.getSurveyResponses('participant_id', { filterType: 'pinned' });
+     */
+    getSurveyResponses(participantId: Identifier, filterParams?: FilterParams): Promise<GroupedSurveyResponse>;
+    /**
+     * Get weekly survey responses for a participant (last 7 days including today)
+     * @param participantId - The participant ID
+     * @param fromDate - Optional custom start date (timestamp)
+     * @param toDate - Optional custom end date (timestamp)
+     * @returns Promise<GroupedSurveyResponse>
+     */
+    getWeeklySurveyResponses(participantId: Identifier, fromDate?: number, toDate?: number): Promise<GroupedSurveyResponse>;
+    /**
+     * Get daily survey responses for a participant
+     * @param participantId - The participant ID
+     * @param date - Optional specific date (timestamp). Defaults to today.
+     * @returns Promise<GroupedSurveyResponse>
+     */
+    getDailySurveyResponses(participantId: Identifier, date?: number): Promise<GroupedSurveyResponse>;
+    /**
+     * Get monthly survey responses for a participant
+     * @param participantId - The participant ID
+     * @param month - Month number (1-12). Defaults to current month.
+     * @param year - Year. Defaults to current year.
+     * @returns Promise<GroupedSurveyResponse>
+     */
+    getMonthlySurveyResponses(participantId: Identifier, month?: number, year?: number): Promise<GroupedSurveyResponse>;
+    /**
+     * Get all survey responses for a participant
+     * @param participantId - The participant ID
+     * @returns Promise<GroupedSurveyResponse>
+     */
+    getAllSurveyResponses(participantId: Identifier): Promise<GroupedSurveyResponse>;
+    /**
+     * Get only pinned survey responses for a participant
+     * @param participantId - The participant ID
+     * @returns Promise<GroupedSurveyResponse>
+     */
+    getPinnedSurveyResponses(participantId: Identifier): Promise<GroupedSurveyResponse>;
+    /**
+     * Pin a survey response for a participant
+     * @param participantId - The participant ID
+     * @param activityId - The survey activity ID
+     * @param timestamp - The timestamp of the response to pin
+     * @returns Promise<PinSurveyResponseResult>
+     *
+     * @example
+     * const result = await LAMP.SurveyResponse.pinSurveyResponse('participant_id', 'activity_id', 1700000000000);
+     */
+    pinSurveyResponse(participantId: Identifier, activityId: string, timestamp: number): Promise<PinSurveyResponseResult>;
+    /**
+     * Unpin a survey response for a participant
+     * @param participantId - The participant ID
+     * @param activityId - The survey activity ID
+     * @param timestamp - The timestamp of the response to unpin
+     * @returns Promise<PinSurveyResponseResult>
+     *
+     * @example
+     * const result = await LAMP.SurveyResponse.unpinSurveyResponse('participant_id', 'activity_id', 1700000000000);
+     */
+    unpinSurveyResponse(participantId: Identifier, activityId: string, timestamp: number): Promise<PinSurveyResponseResult>;
+}

package/dist/service/SurveyResponse.service.js

@@ -0,0 +1,292 @@
+"use strict";
+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.SurveyResponseService = void 0;
+var Fetch_1 = require("./Fetch");
+var SurveyResponseService = /** @class */ (function () {
+    function SurveyResponseService() {
+    }
+    /**
+     * Get survey responses for a participant grouped by survey groups from researcher settings
+     * @param participantId - The participant ID
+     * @param filterParams - Filter parameters for the query
+     * @returns Promise<GroupedSurveyResponse>
+     *
+     * @example
+     * // Get weekly responses (last 7 days)
+     * const result = await LAMP.SurveyResponse.getSurveyResponses('participant_id', { filterType: 'weekly' });
+     *
+     * @example
+     * // Get weekly responses with custom date range
+     * const result = await LAMP.SurveyResponse.getSurveyResponses('participant_id', {
+     *   filterType: 'weekly',
+     *   fromDate: 1700000000000,
+     *   toDate: 1700604800000
+     * });
+     *
+     * @example
+     * // Get daily responses for a specific date
+     * const result = await LAMP.SurveyResponse.getSurveyResponses('participant_id', {
+     *   filterType: 'daily',
+     *   date: 1700000000000
+     * });
+     *
+     * @example
+     * // Get monthly responses
+     * const result = await LAMP.SurveyResponse.getSurveyResponses('participant_id', {
+     *   filterType: 'monthly',
+     *   month: 12,
+     *   year: 2025
+     * });
+     *
+     * @example
+     * // Get all responses
+     * const result = await LAMP.SurveyResponse.getSurveyResponses('participant_id', { filterType: 'all' });
+     *
+     * @example
+     * // Get pinned responses only
+     * const result = await LAMP.SurveyResponse.getSurveyResponses('participant_id', { filterType: 'pinned' });
+     */
+    SurveyResponseService.prototype.getSurveyResponses = function (participantId, filterParams) {
+        var _a;
+        if (filterParams === void 0) { filterParams = { filterType: "weekly" }; }
+        return __awaiter(this, void 0, void 0, function () {
+            var queryParams, result;
+            return __generator(this, function (_b) {
+                switch (_b.label) {
+                    case 0:
+                        if (participantId === null || participantId === undefined) {
+                            throw new Error("Required parameter participantId was null or undefined when calling getSurveyResponses.");
+                        }
+                        if (((_a = this.configuration) === null || _a === void 0 ? void 0 : _a.base) === "https://demo.lamp.digital") {
+                            // DEMO - return empty structure for demo mode
+                            return [2 /*return*/, Promise.resolve({
+                                    groups: [],
+                                    ungroupedSurveys: [],
+                                })];
+                        }
+                        queryParams = new URLSearchParams();
+                        queryParams.set("filterType", filterParams.filterType);
+                        if (filterParams.date !== undefined) {
+                            queryParams.set("date", String(filterParams.date));
+                        }
+                        if (filterParams.fromDate !== undefined) {
+                            queryParams.set("fromDate", String(filterParams.fromDate));
+                        }
+                        if (filterParams.toDate !== undefined) {
+                            queryParams.set("toDate", String(filterParams.toDate));
+                        }
+                        if (filterParams.month !== undefined) {
+                            queryParams.set("month", String(filterParams.month));
+                        }
+                        if (filterParams.year !== undefined) {
+                            queryParams.set("year", String(filterParams.year));
+                        }
+                        return [4 /*yield*/, Fetch_1.Fetch.get("/participant/" + participantId + "/survey_responses?" + queryParams.toString(), this.configuration)];
+                    case 1:
+                        result = _b.sent();
+                        return [2 /*return*/, result.data || { groups: [], ungroupedSurveys: [] }];
+                }
+            });
+        });
+    };
+    /**
+     * Get weekly survey responses for a participant (last 7 days including today)
+     * @param participantId - The participant ID
+     * @param fromDate - Optional custom start date (timestamp)
+     * @param toDate - Optional custom end date (timestamp)
+     * @returns Promise<GroupedSurveyResponse>
+     */
+    SurveyResponseService.prototype.getWeeklySurveyResponses = function (participantId, fromDate, toDate) {
+        return __awaiter(this, void 0, void 0, function () {
+            return __generator(this, function (_a) {
+                return [2 /*return*/, this.getSurveyResponses(participantId, {
+                        filterType: "weekly",
+                        fromDate: fromDate,
+                        toDate: toDate,
+                    })];
+            });
+        });
+    };
+    /**
+     * Get daily survey responses for a participant
+     * @param participantId - The participant ID
+     * @param date - Optional specific date (timestamp). Defaults to today.
+     * @returns Promise<GroupedSurveyResponse>
+     */
+    SurveyResponseService.prototype.getDailySurveyResponses = function (participantId, date) {
+        return __awaiter(this, void 0, void 0, function () {
+            return __generator(this, function (_a) {
+                return [2 /*return*/, this.getSurveyResponses(participantId, {
+                        filterType: "daily",
+                        date: date,
+                    })];
+            });
+        });
+    };
+    /**
+     * Get monthly survey responses for a participant
+     * @param participantId - The participant ID
+     * @param month - Month number (1-12). Defaults to current month.
+     * @param year - Year. Defaults to current year.
+     * @returns Promise<GroupedSurveyResponse>
+     */
+    SurveyResponseService.prototype.getMonthlySurveyResponses = function (participantId, month, year) {
+        return __awaiter(this, void 0, void 0, function () {
+            return __generator(this, function (_a) {
+                return [2 /*return*/, this.getSurveyResponses(participantId, {
+                        filterType: "monthly",
+                        month: month,
+                        year: year,
+                    })];
+            });
+        });
+    };
+    /**
+     * Get all survey responses for a participant
+     * @param participantId - The participant ID
+     * @returns Promise<GroupedSurveyResponse>
+     */
+    SurveyResponseService.prototype.getAllSurveyResponses = function (participantId) {
+        return __awaiter(this, void 0, void 0, function () {
+            return __generator(this, function (_a) {
+                return [2 /*return*/, this.getSurveyResponses(participantId, {
+                        filterType: "all",
+                    })];
+            });
+        });
+    };
+    /**
+     * Get only pinned survey responses for a participant
+     * @param participantId - The participant ID
+     * @returns Promise<GroupedSurveyResponse>
+     */
+    SurveyResponseService.prototype.getPinnedSurveyResponses = function (participantId) {
+        return __awaiter(this, void 0, void 0, function () {
+            return __generator(this, function (_a) {
+                return [2 /*return*/, this.getSurveyResponses(participantId, {
+                        filterType: "pinned",
+                    })];
+            });
+        });
+    };
+    /**
+     * Pin a survey response for a participant
+     * @param participantId - The participant ID
+     * @param activityId - The survey activity ID
+     * @param timestamp - The timestamp of the response to pin
+     * @returns Promise<PinSurveyResponseResult>
+     *
+     * @example
+     * const result = await LAMP.SurveyResponse.pinSurveyResponse('participant_id', 'activity_id', 1700000000000);
+     */
+    SurveyResponseService.prototype.pinSurveyResponse = function (participantId, activityId, timestamp) {
+        var _a;
+        return __awaiter(this, void 0, void 0, function () {
+            var result;
+            return __generator(this, function (_b) {
+                switch (_b.label) {
+                    case 0:
+                        if (participantId === null || participantId === undefined) {
+                            throw new Error("Required parameter participantId was null or undefined when calling pinSurveyResponse.");
+                        }
+                        if (!activityId) {
+                            throw new Error("Required parameter activityId was null or undefined when calling pinSurveyResponse.");
+                        }
+                        if (timestamp === null || timestamp === undefined) {
+                            throw new Error("Required parameter timestamp was null or undefined when calling pinSurveyResponse.");
+                        }
+                        if (((_a = this.configuration) === null || _a === void 0 ? void 0 : _a.base) === "https://demo.lamp.digital") {
+                            // DEMO
+                            return [2 /*return*/, Promise.resolve({ error: "500.demo-restriction" })];
+                        }
+                        return [4 /*yield*/, Fetch_1.Fetch.post("/participant/" + participantId + "/survey_responses/pin", {
+                                activity_id: activityId,
+                                timestamp: timestamp,
+                            }, this.configuration)];
+                    case 1:
+                        result = _b.sent();
+                        return [2 /*return*/, result.data || { success: false, message: "Unknown error" }];
+                }
+            });
+        });
+    };
+    /**
+     * Unpin a survey response for a participant
+     * @param participantId - The participant ID
+     * @param activityId - The survey activity ID
+     * @param timestamp - The timestamp of the response to unpin
+     * @returns Promise<PinSurveyResponseResult>
+     *
+     * @example
+     * const result = await LAMP.SurveyResponse.unpinSurveyResponse('participant_id', 'activity_id', 1700000000000);
+     */
+    SurveyResponseService.prototype.unpinSurveyResponse = function (participantId, activityId, timestamp) {
+        var _a;
+        return __awaiter(this, void 0, void 0, function () {
+            var result;
+            return __generator(this, function (_b) {
+                switch (_b.label) {
+                    case 0:
+                        if (participantId === null || participantId === undefined) {
+                            throw new Error("Required parameter participantId was null or undefined when calling unpinSurveyResponse.");
+                        }
+                        if (!activityId) {
+                            throw new Error("Required parameter activityId was null or undefined when calling unpinSurveyResponse.");
+                        }
+                        if (timestamp === null || timestamp === undefined) {
+                            throw new Error("Required parameter timestamp was null or undefined when calling unpinSurveyResponse.");
+                        }
+                        if (((_a = this.configuration) === null || _a === void 0 ? void 0 : _a.base) === "https://demo.lamp.digital") {
+                            // DEMO
+                            return [2 /*return*/, Promise.resolve({ error: "500.demo-restriction" })];
+                        }
+                        return [4 /*yield*/, Fetch_1.Fetch.delete("/participant/" + participantId + "/survey_responses/pin", this.configuration, {
+                                activity_id: activityId,
+                                timestamp: timestamp,
+                            })];
+                    case 1:
+                        result = _b.sent();
+                        return [2 /*return*/, result.data || { success: false, message: "Unknown error" }];
+                }
+            });
+        });
+    };
+    return SurveyResponseService;
+}());
+exports.SurveyResponseService = SurveyResponseService;

package/dist/service/index.d.ts

@@ -12,3 +12,4 @@ export * from "./Study.service";
 export * from "./Type.service";
 export * from "./API.service";
 export * from "./ImageUpload.service";
+export * from "./SurveyResponse.service";

package/dist/service/index.js

@@ -24,3 +24,4 @@ __exportStar(require("./Study.service"), exports);
 __exportStar(require("./Type.service"), exports);
 __exportStar(require("./API.service"), exports);
 __exportStar(require("./ImageUpload.service"), exports);
+__exportStar(require("./SurveyResponse.service"), exports);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "lamp-core-lst",
-  "version": "2026.1.1-4.2",
+  "version": "2026.1.19",
   "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/index.ts

@@ -15,6 +15,7 @@ import {
   TypeService,
   ResearcherSettingsService,
   ImageUploadService,
+  SurveyResponseService,
 } from "./service/index"
 import { Configuration } from "./service/Fetch"
 import { Demo } from "./service/Demo"
@@ -53,6 +54,7 @@ export default class LAMP {
   public static SensorSpec = new SensorSpecService()
   public static ResearcherSettings = new ResearcherSettingsService()
   public static ImageUpload = new ImageUploadService()
+  public static SurveyResponse = new SurveyResponseService()
   private static get configuration(): Configuration | undefined {
     return LAMP.API.configuration
   }
@@ -71,6 +73,7 @@ export default class LAMP {
     LAMP.Type.configuration = configuration
     LAMP.ResearcherSettings.configuration = configuration
     LAMP.ImageUpload.configuration = configuration
+    LAMP.SurveyResponse.configuration = configuration
   }
   private static protocol = "https://"
 

package/src/service/SurveyResponse.service.ts

@@ -0,0 +1,306 @@
+import { Fetch, Configuration } from "./Fetch"
+import { Identifier } from "../model/Type"
+
+// Types for survey response structure
+export interface SurveyResponse {
+  date: number
+  timestamp: number
+  firstAnswer: any
+  isPinned?: boolean
+}
+
+export interface SurveyItem {
+  id: string
+  title: string
+  binName?: string
+  responses: SurveyResponse[]
+}
+
+export interface SurveyGroup {
+  id: string
+  label: string
+  surveys: SurveyItem[]
+}
+
+export interface GroupedSurveyResponse {
+  groups: SurveyGroup[]
+  ungroupedSurveys: SurveyItem[]
+}
+
+// Filter types for survey responses
+export type FilterType = "weekly" | "daily" | "monthly" | "all" | "pinned"
+
+export interface FilterParams {
+  filterType: FilterType
+  date?: number // For daily filter - specific date timestamp
+  fromDate?: number // For weekly custom range
+  toDate?: number // For weekly custom range
+  month?: number // For monthly filter (1-12)
+  year?: number // For monthly filter
+}
+
+export interface PinSurveyResponseParams {
+  activity_id: string
+  timestamp: number
+}
+
+export interface PinSurveyResponseResult {
+  success: boolean
+  message: string
+}
+
+export class SurveyResponseService {
+  public configuration?: Configuration
+
+  /**
+   * Get survey responses for a participant grouped by survey groups from researcher settings
+   * @param participantId - The participant ID
+   * @param filterParams - Filter parameters for the query
+   * @returns Promise<GroupedSurveyResponse>
+   * 
+   * @example
+   * // Get weekly responses (last 7 days)
+   * const result = await LAMP.SurveyResponse.getSurveyResponses('participant_id', { filterType: 'weekly' });
+   * 
+   * @example
+   * // Get weekly responses with custom date range
+   * const result = await LAMP.SurveyResponse.getSurveyResponses('participant_id', { 
+   *   filterType: 'weekly',
+   *   fromDate: 1700000000000,
+   *   toDate: 1700604800000
+   * });
+   * 
+   * @example
+   * // Get daily responses for a specific date
+   * const result = await LAMP.SurveyResponse.getSurveyResponses('participant_id', { 
+   *   filterType: 'daily',
+   *   date: 1700000000000
+   * });
+   * 
+   * @example
+   * // Get monthly responses
+   * const result = await LAMP.SurveyResponse.getSurveyResponses('participant_id', { 
+   *   filterType: 'monthly',
+   *   month: 12,
+   *   year: 2025
+   * });
+   * 
+   * @example
+   * // Get all responses
+   * const result = await LAMP.SurveyResponse.getSurveyResponses('participant_id', { filterType: 'all' });
+   * 
+   * @example
+   * // Get pinned responses only
+   * const result = await LAMP.SurveyResponse.getSurveyResponses('participant_id', { filterType: 'pinned' });
+   */
+  public async getSurveyResponses(
+    participantId: Identifier,
+    filterParams: FilterParams = { filterType: "weekly" }
+  ): Promise<GroupedSurveyResponse> {
+    if (participantId === null || participantId === undefined) {
+      throw new Error(
+        "Required parameter participantId was null or undefined when calling getSurveyResponses."
+      )
+    }
+
+    if (this.configuration?.base === "https://demo.lamp.digital") {
+      // DEMO - return empty structure for demo mode
+      return Promise.resolve({
+        groups: [],
+        ungroupedSurveys: [],
+      })
+    }
+
+    // Build query parameters
+    const queryParams = new URLSearchParams()
+    queryParams.set("filterType", filterParams.filterType)
+    
+    if (filterParams.date !== undefined) {
+      queryParams.set("date", String(filterParams.date))
+    }
+    if (filterParams.fromDate !== undefined) {
+      queryParams.set("fromDate", String(filterParams.fromDate))
+    }
+    if (filterParams.toDate !== undefined) {
+      queryParams.set("toDate", String(filterParams.toDate))
+    }
+    if (filterParams.month !== undefined) {
+      queryParams.set("month", String(filterParams.month))
+    }
+    if (filterParams.year !== undefined) {
+      queryParams.set("year", String(filterParams.year))
+    }
+
+    const result = await Fetch.get<{ data: GroupedSurveyResponse }>(
+      `/participant/${participantId}/survey_responses?${queryParams.toString()}`,
+      this.configuration
+    )
+
+    return result.data || { groups: [], ungroupedSurveys: [] }
+  }
+
+  /**
+   * Get weekly survey responses for a participant (last 7 days including today)
+   * @param participantId - The participant ID
+   * @param fromDate - Optional custom start date (timestamp)
+   * @param toDate - Optional custom end date (timestamp)
+   * @returns Promise<GroupedSurveyResponse>
+   */
+  public async getWeeklySurveyResponses(
+    participantId: Identifier,
+    fromDate?: number,
+    toDate?: number
+  ): Promise<GroupedSurveyResponse> {
+    return this.getSurveyResponses(participantId, {
+      filterType: "weekly",
+      fromDate,
+      toDate,
+    })
+  }
+
+  /**
+   * Get daily survey responses for a participant
+   * @param participantId - The participant ID
+   * @param date - Optional specific date (timestamp). Defaults to today.
+   * @returns Promise<GroupedSurveyResponse>
+   */
+  public async getDailySurveyResponses(
+    participantId: Identifier,
+    date?: number
+  ): Promise<GroupedSurveyResponse> {
+    return this.getSurveyResponses(participantId, {
+      filterType: "daily",
+      date,
+    })
+  }
+
+  /**
+   * Get monthly survey responses for a participant
+   * @param participantId - The participant ID
+   * @param month - Month number (1-12). Defaults to current month.
+   * @param year - Year. Defaults to current year.
+   * @returns Promise<GroupedSurveyResponse>
+   */
+  public async getMonthlySurveyResponses(
+    participantId: Identifier,
+    month?: number,
+    year?: number
+  ): Promise<GroupedSurveyResponse> {
+    return this.getSurveyResponses(participantId, {
+      filterType: "monthly",
+      month,
+      year,
+    })
+  }
+
+  /**
+   * Get all survey responses for a participant
+   * @param participantId - The participant ID
+   * @returns Promise<GroupedSurveyResponse>
+   */
+  public async getAllSurveyResponses(participantId: Identifier): Promise<GroupedSurveyResponse> {
+    return this.getSurveyResponses(participantId, {
+      filterType: "all",
+    })
+  }
+
+  /**
+   * Get only pinned survey responses for a participant
+   * @param participantId - The participant ID
+   * @returns Promise<GroupedSurveyResponse>
+   */
+  public async getPinnedSurveyResponses(participantId: Identifier): Promise<GroupedSurveyResponse> {
+    return this.getSurveyResponses(participantId, {
+      filterType: "pinned",
+    })
+  }
+
+  /**
+   * Pin a survey response for a participant
+   * @param participantId - The participant ID
+   * @param activityId - The survey activity ID
+   * @param timestamp - The timestamp of the response to pin
+   * @returns Promise<PinSurveyResponseResult>
+   * 
+   * @example
+   * const result = await LAMP.SurveyResponse.pinSurveyResponse('participant_id', 'activity_id', 1700000000000);
+   */
+  public async pinSurveyResponse(
+    participantId: Identifier,
+    activityId: string,
+    timestamp: number
+  ): Promise<PinSurveyResponseResult> {
+    if (participantId === null || participantId === undefined) {
+      throw new Error(
+        "Required parameter participantId was null or undefined when calling pinSurveyResponse."
+      )
+    }
+    if (!activityId) {
+      throw new Error("Required parameter activityId was null or undefined when calling pinSurveyResponse.")
+    }
+    if (timestamp === null || timestamp === undefined) {
+      throw new Error("Required parameter timestamp was null or undefined when calling pinSurveyResponse.")
+    }
+
+    if (this.configuration?.base === "https://demo.lamp.digital") {
+      // DEMO
+      return Promise.resolve({ error: "500.demo-restriction" } as any)
+    }
+
+    const result = await Fetch.post<{ data: PinSurveyResponseResult }>(
+      `/participant/${participantId}/survey_responses/pin`,
+      {
+        activity_id: activityId,
+        timestamp: timestamp,
+      },
+      this.configuration
+    )
+
+    return result.data || { success: false, message: "Unknown error" }
+  }
+
+  /**
+   * Unpin a survey response for a participant
+   * @param participantId - The participant ID
+   * @param activityId - The survey activity ID
+   * @param timestamp - The timestamp of the response to unpin
+   * @returns Promise<PinSurveyResponseResult>
+   * 
+   * @example
+   * const result = await LAMP.SurveyResponse.unpinSurveyResponse('participant_id', 'activity_id', 1700000000000);
+   */
+  public async unpinSurveyResponse(
+    participantId: Identifier,
+    activityId: string,
+    timestamp: number
+  ): Promise<PinSurveyResponseResult> {
+    if (participantId === null || participantId === undefined) {
+      throw new Error(
+        "Required parameter participantId was null or undefined when calling unpinSurveyResponse."
+      )
+    }
+    if (!activityId) {
+      throw new Error("Required parameter activityId was null or undefined when calling unpinSurveyResponse.")
+    }
+    if (timestamp === null || timestamp === undefined) {
+      throw new Error("Required parameter timestamp was null or undefined when calling unpinSurveyResponse.")
+    }
+
+    if (this.configuration?.base === "https://demo.lamp.digital") {
+      // DEMO
+      return Promise.resolve({ error: "500.demo-restriction" } as any)
+    }
+
+    const result = await Fetch.delete<{ data: PinSurveyResponseResult }>(
+      `/participant/${participantId}/survey_responses/pin`,
+      this.configuration,
+      {
+        activity_id: activityId,
+        timestamp: timestamp,
+      }
+    )
+
+    return result.data || { success: false, message: "Unknown error" }
+  }
+}
+

package/src/service/index.ts

@@ -12,3 +12,4 @@ export * from "./Study.service"
 export * from "./Type.service"
 export * from "./API.service"
 export * from "./ImageUpload.service"
+export * from "./SurveyResponse.service"