@emiran/omu-ubys 0.1.0 → 0.2.0

package/dist/index.d.cts

@@ -76,6 +76,37 @@ interface ClassDetailSurvey {
     url?: string;
     expired?: boolean;
 }
+interface SurveyChoice {
+    id: string;
+    text: string;
+}
+interface SurveyQuestion {
+    id: string;
+    text: string;
+    required: boolean;
+    choices: SurveyChoice[];
+}
+interface SurveyPage {
+    id: string;
+    title: string;
+    description?: string;
+    questions: SurveyQuestion[];
+    choiceLabels: string[];
+}
+interface SurveyData {
+    url: string;
+    title: string;
+    description: string;
+    courseName?: string;
+    surveyId: string;
+    surveyUserId: string;
+    redirectUrl?: string;
+    pages: SurveyPage[];
+}
+interface SurveyCheckResult {
+    hasPendingSurvey: boolean;
+    surveys?: SurveyData[];
+}
 interface ClassDetail {
     exams: Exam[];
     students: Student[];
@@ -217,6 +248,25 @@ declare class UBYSClient {
     getClassDetails(classId: string): Promise<ClassDetail>;
     getTranscript(): Promise<Semester[]>;
     getWeeklySchedule(): Promise<ScheduleItem[]>;
+    /**
+     * Check whether there are any mandatory portal-level surveys blocking access.
+     * Navigates to the student home page and detects PortalSurveyManagement redirects.
+     * If surveys are found they are fetched and returned.
+     */
+    getPendingSurveys(): Promise<SurveyCheckResult>;
+    /**
+     * Fetch and parse a single MES survey participant page.
+     *
+     * @param surveyUrl - Full URL (e.g. https://ubys.omu.edu.tr/MES/Application/Public/Participant?Id=…)
+     */
+    fetchSurvey(surveyUrl: string): Promise<SurveyData>;
+    /**
+     * Submit answers for a survey.
+     *
+     * @param surveyData - The SurveyData returned by `fetchSurvey()`
+     * @param answers - Map of questionId → choiceId
+     */
+    submitSurvey(surveyData: SurveyData, answers: Record<string, string>): Promise<void>;
     clearSession(): void;
     close(): Promise<void>;
     private ensureAuthenticated;
@@ -261,4 +311,4 @@ declare class ClientClosedError extends UBYSError {
     constructor(message?: string, options?: UBYSErrorOptions);
 }
 
-export { type Advisor, AuthenticationError, type CafeteriaMenu, type Chat, type ChatMessage, type ChatMessageReceipt, type ChatMessageSearchOptions, type ChatMessageSearchResult, type ChatRecipient, type ChatRecipientSearchOptions, type ChatRecipientSearchResult, type ChatSearchOptions, type ChatSearchResult, type ClassDetail, type ClassDetailSurvey, ClientClosedError, type Course, type Exam, HttpError, type Instructor, LoginError, type MenuItem, NetworkError, NotImplementedUBYSError, ParseError, type ScheduleItem, type Semester, SessionExpiredError, type Student, type StudentInfoPayload, type StudentProgram, UBYSClient, type UBYSClientOptions, UBYSError, type UserProfile };
+export { type Advisor, AuthenticationError, type CafeteriaMenu, type Chat, type ChatMessage, type ChatMessageReceipt, type ChatMessageSearchOptions, type ChatMessageSearchResult, type ChatRecipient, type ChatRecipientSearchOptions, type ChatRecipientSearchResult, type ChatSearchOptions, type ChatSearchResult, type ClassDetail, type ClassDetailSurvey, ClientClosedError, type Course, type Exam, HttpError, type Instructor, LoginError, type MenuItem, NetworkError, NotImplementedUBYSError, ParseError, type ScheduleItem, type Semester, SessionExpiredError, type Student, type StudentInfoPayload, type StudentProgram, type SurveyCheckResult, type SurveyChoice, type SurveyData, type SurveyPage, type SurveyQuestion, UBYSClient, type UBYSClientOptions, UBYSError, type UserProfile };

package/dist/index.d.ts

@@ -76,6 +76,37 @@ interface ClassDetailSurvey {
     url?: string;
     expired?: boolean;
 }
+interface SurveyChoice {
+    id: string;
+    text: string;
+}
+interface SurveyQuestion {
+    id: string;
+    text: string;
+    required: boolean;
+    choices: SurveyChoice[];
+}
+interface SurveyPage {
+    id: string;
+    title: string;
+    description?: string;
+    questions: SurveyQuestion[];
+    choiceLabels: string[];
+}
+interface SurveyData {
+    url: string;
+    title: string;
+    description: string;
+    courseName?: string;
+    surveyId: string;
+    surveyUserId: string;
+    redirectUrl?: string;
+    pages: SurveyPage[];
+}
+interface SurveyCheckResult {
+    hasPendingSurvey: boolean;
+    surveys?: SurveyData[];
+}
 interface ClassDetail {
     exams: Exam[];
     students: Student[];
@@ -217,6 +248,25 @@ declare class UBYSClient {
     getClassDetails(classId: string): Promise<ClassDetail>;
     getTranscript(): Promise<Semester[]>;
     getWeeklySchedule(): Promise<ScheduleItem[]>;
+    /**
+     * Check whether there are any mandatory portal-level surveys blocking access.
+     * Navigates to the student home page and detects PortalSurveyManagement redirects.
+     * If surveys are found they are fetched and returned.
+     */
+    getPendingSurveys(): Promise<SurveyCheckResult>;
+    /**
+     * Fetch and parse a single MES survey participant page.
+     *
+     * @param surveyUrl - Full URL (e.g. https://ubys.omu.edu.tr/MES/Application/Public/Participant?Id=…)
+     */
+    fetchSurvey(surveyUrl: string): Promise<SurveyData>;
+    /**
+     * Submit answers for a survey.
+     *
+     * @param surveyData - The SurveyData returned by `fetchSurvey()`
+     * @param answers - Map of questionId → choiceId
+     */
+    submitSurvey(surveyData: SurveyData, answers: Record<string, string>): Promise<void>;
     clearSession(): void;
     close(): Promise<void>;
     private ensureAuthenticated;
@@ -261,4 +311,4 @@ declare class ClientClosedError extends UBYSError {
     constructor(message?: string, options?: UBYSErrorOptions);
 }
 
-export { type Advisor, AuthenticationError, type CafeteriaMenu, type Chat, type ChatMessage, type ChatMessageReceipt, type ChatMessageSearchOptions, type ChatMessageSearchResult, type ChatRecipient, type ChatRecipientSearchOptions, type ChatRecipientSearchResult, type ChatSearchOptions, type ChatSearchResult, type ClassDetail, type ClassDetailSurvey, ClientClosedError, type Course, type Exam, HttpError, type Instructor, LoginError, type MenuItem, NetworkError, NotImplementedUBYSError, ParseError, type ScheduleItem, type Semester, SessionExpiredError, type Student, type StudentInfoPayload, type StudentProgram, UBYSClient, type UBYSClientOptions, UBYSError, type UserProfile };
+export { type Advisor, AuthenticationError, type CafeteriaMenu, type Chat, type ChatMessage, type ChatMessageReceipt, type ChatMessageSearchOptions, type ChatMessageSearchResult, type ChatRecipient, type ChatRecipientSearchOptions, type ChatRecipientSearchResult, type ChatSearchOptions, type ChatSearchResult, type ClassDetail, type ClassDetailSurvey, ClientClosedError, type Course, type Exam, HttpError, type Instructor, LoginError, type MenuItem, NetworkError, NotImplementedUBYSError, ParseError, type ScheduleItem, type Semester, SessionExpiredError, type Student, type StudentInfoPayload, type StudentProgram, type SurveyCheckResult, type SurveyChoice, type SurveyData, type SurveyPage, type SurveyQuestion, UBYSClient, type UBYSClientOptions, UBYSError, type UserProfile };

package/dist/index.js

@@ -1023,6 +1023,167 @@ function textOrUndefined3(value) {
 function normalizeText2(value) {
   return decodeHtmlEntities(value).replace(/\s+/g, " ").trim();
 }
+function parseSurveyPage(html, surveyUrl) {
+  if (html.includes("/Account/Login")) {
+    throw new SessionExpiredError();
+  }
+  const $ = load(html);
+  const description = $(".panel-body p").first().text().trim();
+  let surveyId = "";
+  let surveyUserId = "";
+  let redirectUrl = "";
+  $("script").each((_, script) => {
+    const content = $(script).html() ?? "";
+    const base64Match = content.match(
+      /var\s+_jsm\s*=\s*null;\s*\(function\(\)\s*\{\s*_jsm\s*=\s*JSON\.parse\(Base64\.decode\(["']([^"']+)["']\)/
+    );
+    if (base64Match) {
+      try {
+        const encoded = base64Match[1];
+        if (!encoded) return;
+        const decoded = Buffer.from(encoded, "base64").toString("utf-8");
+        const jsmObj = JSON.parse(decoded);
+        if (typeof jsmObj["SurveyId"] === "number" && !surveyId) {
+          surveyId = String(jsmObj["SurveyId"]);
+        }
+        const survey = jsmObj["Survey"];
+        if (typeof survey?.["Id"] === "number" && !surveyId) {
+          surveyId = String(survey["Id"]);
+        }
+        const surveyUser = jsmObj["SurveyUser"];
+        if (typeof surveyUser?.["Id"] === "number" && !surveyUserId) {
+          surveyUserId = String(surveyUser["Id"]);
+        }
+        if (typeof jsmObj["RedirectPageUrl"] === "string" && !redirectUrl) {
+          redirectUrl = jsmObj["RedirectPageUrl"];
+        }
+      } catch {
+      }
+    }
+    if (!surveyId) {
+      const m = content.match(/Survey\s*:\s*\{\s*Id\s*:\s*(\d+)/);
+      if (m) surveyId = m[1] ?? "";
+    }
+    if (!surveyUserId) {
+      const m = content.match(/SurveyUser\s*:\s*\{\s*Id\s*:\s*(\d+)/);
+      if (m) surveyUserId = m[1] ?? "";
+    }
+    if (!redirectUrl) {
+      const m = content.match(/RedirectPageUrl\s*:\s*["']([^"']+)["']/);
+      if (m) redirectUrl = m[1] ?? "";
+    }
+  });
+  if (!surveyId) {
+    surveyId = $("#surveyParent").attr("data-survey-id") ?? "";
+  }
+  if (!surveyUserId) {
+    const m = surveyUrl.match(/[?&]Id=(\d+)/i);
+    if (m) surveyUserId = m[1] ?? "";
+  }
+  if (!redirectUrl) {
+    try {
+      const urlObj = new URL(surveyUrl);
+      redirectUrl = urlObj.searchParams.get("RedirectPageUrl") ?? "";
+    } catch {
+    }
+  }
+  if (!surveyId && !surveyUserId) {
+    throw new ParseError("Could not extract surveyId or surveyUserId from survey page.", {
+      details: { surveyUrl }
+    });
+  }
+  const pages = parseSurveyPages($);
+  return {
+    url: surveyUrl,
+    title: "Ders De\u011Ferlendirme Anketi",
+    description,
+    surveyId,
+    surveyUserId,
+    ...redirectUrl ? { redirectUrl } : {},
+    pages
+  };
+}
+function parseSurveyPages($) {
+  const pages = [];
+  $(".survey-page").each((_, pageEl) => {
+    const pageId = $(pageEl).attr("data-page-id") ?? "";
+    if (!pageId) return;
+    const pageTitleText = $(pageEl).text().trim();
+    const pageBody = $(pageEl).closest(".panel").find(".panel-body");
+    const questions = [];
+    const choiceLabels = [];
+    const table = pageBody.find("table");
+    if (table.length > 0) {
+      table.find("thead th").each((idx, th) => {
+        const choiceText = $(th).text().trim();
+        if (choiceText && idx > 0) {
+          choiceLabels.push(choiceText);
+        }
+      });
+      table.find("tbody tr[data-question-id]").each((_2, row) => {
+        const questionId = $(row).attr("data-question-id") ?? "";
+        const questionText = $(row).find("td").first().text().trim();
+        const isRequired = $(row).hasClass("forRequired");
+        const questionChoices = [];
+        $(row).find('input[type="radio"]').each((idx, input) => {
+          const choiceId = $(input).attr("data-choise-id") ?? "";
+          if (choiceId) {
+            questionChoices.push({
+              id: choiceId,
+              text: choiceLabels[idx] ?? `Option ${idx + 1}`
+            });
+          }
+        });
+        if (questionId && questionText) {
+          questions.push({
+            id: questionId,
+            text: questionText,
+            required: isRequired,
+            choices: questionChoices
+          });
+        }
+      });
+    }
+    pages.push({
+      id: pageId,
+      title: pageTitleText,
+      questions,
+      choiceLabels
+    });
+  });
+  return pages;
+}
+function buildSurveySubmitBody(surveyData, answers) {
+  const choises = Object.entries(answers).map(([questionId, choiceId]) => ({
+    Id: 0,
+    SelectedOrder: null,
+    SurveyQuestionId: parseInt(questionId, 10),
+    SurveyUserId: parseInt(surveyData.surveyUserId, 10),
+    SurveyQuestionChoiseId: parseInt(choiceId, 10),
+    Text: "",
+    IsIrrevelant: false
+  }));
+  return {
+    choises,
+    RedirectPageUrl: surveyData.redirectUrl ?? "",
+    surveyId: parseInt(surveyData.surveyId, 10)
+  };
+}
+function extractSurveyCsrfToken(html) {
+  const $ = load(html);
+  const token = $('input[name="__RequestVerificationToken"]').val();
+  return typeof token === "string" && token ? token : void 0;
+}
+function parseSurveyLinks(html, baseUrl) {
+  const $ = load(html);
+  const links = [];
+  $('a[href*="MES/Application/Public/Participant"]').each((_, el) => {
+    const href = $(el).attr("href");
+    if (!href) return;
+    links.push(href.startsWith("http") ? href : `${baseUrl}${href}`);
+  });
+  return links;
+}
 
 // src/client.ts
 var UBYSClient = class {
@@ -1279,6 +1440,89 @@ var UBYSClient = class {
     this.session.assertNotLoginRedirect(response);
     return parseWeeklySchedule(response.body);
   }
+  /**
+   * Check whether there are any mandatory portal-level surveys blocking access.
+   * Navigates to the student home page and detects PortalSurveyManagement redirects.
+   * If surveys are found they are fetched and returned.
+   */
+  async getPendingSurveys() {
+    this.ensureAuthenticated();
+    const homeResponse = await this.session.get("AIS/Student/Home/Index");
+    this.session.assertOk(homeResponse);
+    const responseUrl = homeResponse.url;
+    const html = homeResponse.body;
+    const redirectedToSurvey = responseUrl.includes("PortalSurveyManagement");
+    const htmlMentionsSurvey = html.includes("Zorunlu olan anketi");
+    if (!redirectedToSurvey && !htmlMentionsSurvey) {
+      return { hasPendingSurvey: false };
+    }
+    if (redirectedToSurvey) {
+      let requestedUrl = null;
+      try {
+        requestedUrl = new URL(responseUrl).searchParams.get("RequestedUrl");
+      } catch {
+      }
+      if (requestedUrl) {
+        const retryResponse = await this.session.get(requestedUrl);
+        if (!retryResponse.url.includes("PortalSurveyManagement")) {
+          return { hasPendingSurvey: false };
+        }
+      }
+      const surveyLinks = parseSurveyLinks(html, this.session.baseUrl);
+      if (surveyLinks.length > 0) {
+        const surveys = [];
+        for (const link of surveyLinks) {
+          try {
+            const survey = await this.fetchSurvey(link);
+            surveys.push(survey);
+          } catch {
+          }
+        }
+        return { hasPendingSurvey: true, ...surveys.length > 0 ? { surveys } : {} };
+      }
+    }
+    return { hasPendingSurvey: true };
+  }
+  /**
+   * Fetch and parse a single MES survey participant page.
+   *
+   * @param surveyUrl - Full URL (e.g. https://ubys.omu.edu.tr/MES/Application/Public/Participant?Id=…)
+   */
+  async fetchSurvey(surveyUrl) {
+    this.ensureAuthenticated();
+    const response = await this.session.get(surveyUrl);
+    this.session.assertOk(response);
+    this.session.assertNotLoginRedirect(response);
+    return parseSurveyPage(response.body, surveyUrl);
+  }
+  /**
+   * Submit answers for a survey.
+   *
+   * @param surveyData - The SurveyData returned by `fetchSurvey()`
+   * @param answers - Map of questionId → choiceId
+   */
+  async submitSurvey(surveyData, answers) {
+    this.ensureAuthenticated();
+    const pageResponse = await this.session.get(surveyData.url);
+    this.session.assertOk(pageResponse);
+    this.session.assertNotLoginRedirect(pageResponse);
+    const csrfToken = extractSurveyCsrfToken(pageResponse.body);
+    if (!csrfToken) {
+      throw new Error("CSRF token not found on survey page.");
+    }
+    const body = buildSurveySubmitBody(surveyData, answers);
+    const finishUrl = `${this.session.baseUrl}/MES/Application/Public/FinishSurvey`;
+    const submitResponse = await this.session.post(finishUrl, {
+      body: JSON.stringify(body),
+      headers: {
+        "content-type": "application/json; charset=UTF-8",
+        "x-requested-with": "XMLHttpRequest",
+        "x-requestverificationtoken": csrfToken,
+        referer: surveyData.url
+      }
+    });
+    this.session.assertOk(submitResponse);
+  }
   clearSession() {
     this.ensureOpen();
     this.state = {