@emiran/omu-ubys 0.1.0

package/dist/index.cjs

@@ -0,0 +1,1347 @@
+'use strict';
+
+var cheerio = require('cheerio');
+var got = require('got');
+var toughCookie = require('tough-cookie');
+
+function _interopDefault (e) { return e && e.__esModule ? e : { default: e }; }
+
+var got__default = /*#__PURE__*/_interopDefault(got);
+
+// src/client.ts
+
+// src/errors.ts
+var UBYSError = class extends Error {
+  code;
+  details;
+  constructor(message, options = {}) {
+    super(message, { cause: options.cause });
+    this.name = new.target.name;
+    this.code = options.code ?? "UBYS_ERROR";
+    this.details = options.details;
+  }
+};
+var AuthenticationError = class extends UBYSError {
+  constructor(message = "Authentication failed.", options = {}) {
+    super(message, { ...options, code: options.code ?? "AUTHENTICATION_ERROR" });
+  }
+};
+var LoginError = class extends AuthenticationError {
+  constructor(message = "Login failed.", options = {}) {
+    super(message, { ...options, code: options.code ?? "LOGIN_ERROR" });
+  }
+};
+var SessionExpiredError = class extends AuthenticationError {
+  constructor(message = "UBYS session expired.", options = {}) {
+    super(message, { ...options, code: options.code ?? "SESSION_EXPIRED" });
+  }
+};
+var NetworkError = class extends UBYSError {
+  constructor(message = "Network request failed.", options = {}) {
+    super(message, { ...options, code: options.code ?? "NETWORK_ERROR" });
+  }
+};
+var HttpError = class extends UBYSError {
+  statusCode;
+  constructor(statusCode, message = `Unexpected HTTP status: ${statusCode}`, options = {}) {
+    super(message, { ...options, code: options.code ?? "HTTP_ERROR" });
+    this.statusCode = statusCode;
+  }
+};
+var ParseError = class extends UBYSError {
+  constructor(message = "Failed to parse UBYS response.", options = {}) {
+    super(message, { ...options, code: options.code ?? "PARSE_ERROR" });
+  }
+};
+var NotImplementedUBYSError = class extends UBYSError {
+  constructor(message = "This UBYS feature is planned but not implemented yet.", options = {}) {
+    super(message, { ...options, code: options.code ?? "NOT_IMPLEMENTED" });
+  }
+};
+var ClientClosedError = class extends UBYSError {
+  constructor(message = "This UBYS client has been closed.", options = {}) {
+    super(message, { ...options, code: options.code ?? "CLIENT_CLOSED" });
+  }
+};
+
+// src/http/constants.ts
+var UBYS_BASE_URL = "https://ubys.omu.edu.tr";
+var OMU_CAFETERIA_URL = "https://sks.omu.edu.tr/gunun-yemegi/";
+var DEFAULT_HEADERS = {
+  "user-agent": "Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/120.0.0.0 Safari/537.36",
+  "accept-language": "tr-TR,tr;q=0.9,en-US;q=0.8,en;q=0.7",
+  "accept-encoding": "gzip, deflate, br",
+  connection: "keep-alive",
+  "sec-ch-ua": '"Not_A Brand";v="8", "Chromium";v="120", "Google Chrome";v="120"',
+  "sec-ch-ua-mobile": "?0",
+  "sec-ch-ua-platform": '"Windows"'
+};
+var AJAX_HEADERS = {
+  "x-requested-with": "XMLHttpRequest"
+};
+
+// src/auth/login.ts
+var CSRF_TOKEN_PATTERN = /name="__RequestVerificationToken".*?value="([^"]+)"/;
+function extractCsrfToken(html) {
+  const match = html.match(CSRF_TOKEN_PATTERN);
+  if (!match?.[1]) {
+    throw new ParseError("CSRF token could not be extracted from the UBYS login page.");
+  }
+  return match[1];
+}
+async function loginWithCredentials(session, username, password) {
+  const homepage = await session.get("/");
+  session.assertOk(homepage);
+  const csrfToken = extractCsrfToken(homepage.body);
+  const response = await session.post("Account/Login", {
+    form: {
+      __RequestVerificationToken: csrfToken,
+      username,
+      password
+    },
+    headers: {
+      ...AJAX_HEADERS,
+      "content-type": "application/x-www-form-urlencoded; charset=UTF-8",
+      referer: `${session.baseUrl}/`
+    }
+  });
+  let data;
+  try {
+    data = JSON.parse(response.body);
+  } catch (error) {
+    throw new LoginError("UBYS returned an unexpected login response.", { cause: error });
+  }
+  if (data.errorType === "error" || data.errorMessage) {
+    throw new LoginError(data.errorMessage ?? "Invalid username or password.", {
+      details: {
+        statusCode: response.statusCode
+      }
+    });
+  }
+  return data;
+}
+var UBYSSession = class {
+  baseUrl;
+  cookieJar;
+  client;
+  closed = false;
+  constructor(options = {}) {
+    this.baseUrl = options.baseUrl ?? UBYS_BASE_URL;
+    this.cookieJar = new toughCookie.CookieJar();
+    const config = {
+      prefixUrl: this.baseUrl,
+      cookieJar: this.cookieJar,
+      headers: {
+        ...DEFAULT_HEADERS,
+        ...options.headers
+      },
+      followRedirect: true,
+      resolveBodyOnly: false,
+      throwHttpErrors: false,
+      timeout: {
+        request: options.timeoutMs ?? 3e4
+      },
+      retry: {
+        limit: 1,
+        methods: ["GET", "POST"]
+      },
+      https: {
+        rejectUnauthorized: true
+      }
+    };
+    this.client = got__default.default.extend(config);
+  }
+  async get(pathOrUrl, options = {}) {
+    return this.request(pathOrUrl, { ...options, method: "GET" });
+  }
+  async post(pathOrUrl, options = {}) {
+    return this.request(pathOrUrl, { ...options, method: "POST" });
+  }
+  get isClosed() {
+    return this.closed;
+  }
+  async close() {
+    if (this.closed) {
+      return;
+    }
+    await new Promise((resolve, reject) => {
+      this.cookieJar.removeAllCookies((error) => {
+        if (error) {
+          reject(error);
+          return;
+        }
+        resolve();
+      });
+    });
+    this.closed = true;
+  }
+  assertOk(response, allowedStatusCodes = [200]) {
+    if (!allowedStatusCodes.includes(response.statusCode)) {
+      throw new HttpError(response.statusCode, `Unexpected HTTP status: ${response.statusCode}`, {
+        details: {
+          url: response.url
+        }
+      });
+    }
+  }
+  assertNotLoginRedirect(response) {
+    if (response.url.includes("/Account/Login")) {
+      throw new SessionExpiredError();
+    }
+  }
+  async request(pathOrUrl, options) {
+    this.ensureOpen();
+    try {
+      if (/^https?:\/\//.test(pathOrUrl)) {
+        return await this.client(pathOrUrl, options);
+      }
+      const normalizedPath = pathOrUrl.replace(/^\//, "");
+      return await this.client(normalizedPath, options);
+    } catch (error) {
+      throw new NetworkError("Failed to reach UBYS.", { cause: error });
+    }
+  }
+  ensureOpen() {
+    if (this.closed) {
+      throw new ClientClosedError();
+    }
+  }
+};
+
+// src/utils/base64.ts
+function decodeBase64Json(value, context) {
+  try {
+    const json = Buffer.from(value, "base64").toString("utf8");
+    return JSON.parse(json);
+  } catch (error) {
+    throw new ParseError(`Failed to decode ${context}.`, { cause: error });
+  }
+}
+
+// src/parsers/profile.ts
+var STUDENT_INFO_PATTERN = /StudentInfo\s*=\s*JSON\.parse\(Base64\.decode\(["']([^"']+)["']\)\)/;
+var SAP_ID_PATTERN = /selectAcademicProgram\('([^']+)'\)/;
+function extractStudentInfo(html) {
+  const match = html.match(STUDENT_INFO_PATTERN);
+  if (!match?.[1]) {
+    if (isLoginPage(html)) {
+      throw new SessionExpiredError();
+    }
+    throw new ParseError("StudentInfo could not be found in dashboard HTML.");
+  }
+  return decodeBase64Json(match[1], "StudentInfo payload");
+}
+function extractSapId(html) {
+  const match = html.match(SAP_ID_PATTERN);
+  return match?.[1];
+}
+function toUserProfile(studentNumber, studentInfo, sapId, displayName) {
+  const program = studentInfo.Programs?.[0];
+  const person = studentInfo.Person?.Person;
+  const fallbackName = [person?.Name, person?.Surname].filter(Boolean).join(" ").trim();
+  return {
+    name: displayName ?? fallbackName,
+    studentNumber,
+    faculty: extractFaculty(program?.UnitName),
+    department: program?.AcademicProgramName ?? "",
+    ...sapId ? { sapId } : {},
+    ...program?.StudentId !== void 0 ? { studentId: program.StudentId } : {},
+    ...program?.RecordSemester !== void 0 ? { semesterId: program.RecordSemester } : {},
+    ...program?.RecordYear !== void 0 ? { academicYear: program.RecordYear } : {},
+    ...program?.GANO !== void 0 ? { cumulativeGpa: program.GANO } : {}
+  };
+}
+function isLoginPage(html) {
+  return html.includes("/Account/Login") || html.toLowerCase().includes("login-form");
+}
+function extractFaculty(unitName) {
+  if (!unitName) {
+    return "";
+  }
+  return unitName.split(" - ")[0]?.trim() ?? unitName;
+}
+
+// src/parsers/advisor.ts
+function parseAdvisor(html) {
+  if (isLoginPage(html)) {
+    throw new SessionExpiredError();
+  }
+  const $ = cheerio.load(html);
+  let name;
+  let email;
+  $("dt").each((_, element) => {
+    const label = $(element).text().trim();
+    const value = $(element).next("dd").text().trim();
+    if (!value) {
+      return;
+    }
+    if (!name && label.includes("Ad Soyad")) {
+      name = value;
+    }
+    if (!email && (label.includes("Mail") || label.includes("E-Posta"))) {
+      email = value.replace(/^mailto:/i, "");
+    }
+  });
+  if (!name) {
+    return null;
+  }
+  return {
+    name,
+    ...email ? { email } : {}
+  };
+}
+function parseCafeteriaMenu(html) {
+  const $ = cheerio.load(html);
+  const table = $("div.reading table.has-fixed-layout").first();
+  const items = [];
+  let date = "";
+  table.find("tbody tr").each((_, element) => {
+    const cells = $(element).find("td");
+    const label = cells.eq(0).text().trim();
+    const value = cells.eq(1).text().trim();
+    if (!label || !value) {
+      return;
+    }
+    if (label.toLowerCase() === "tarih") {
+      date = value;
+      return;
+    }
+    items.push({
+      name: value,
+      category: label
+    });
+  });
+  if (items.length === 0) {
+    return null;
+  }
+  return {
+    date: date || "Bugun",
+    items
+  };
+}
+function decodeHtmlEntities(value) {
+  return cheerio.load(`<div>${value}</div>`)("div").text();
+}
+
+// src/utils/parse.ts
+function parseNumber(value) {
+  const normalized = value.trim().replace(/\s+/g, "").replace(",", ".");
+  if (!normalized || normalized === "-") {
+    return void 0;
+  }
+  const parsed = Number(normalized);
+  return Number.isFinite(parsed) ? parsed : void 0;
+}
+
+// src/parsers/class-details.ts
+var LETTER_GRADE_PATTERN = /\b(AA|BA|BB|CB|CC|DC|DD|FD|FF)\b/i;
+function parseClassDetail(html) {
+  if (html.includes("/Account/Login")) {
+    throw new SessionExpiredError();
+  }
+  const $ = cheerio.load(html);
+  const exams = parseExamTable($);
+  const instructor = parseInstructor($);
+  const status = parseStatus($);
+  const letterGradeMatch = status?.match(LETTER_GRADE_PATTERN);
+  const letterGrade = letterGradeMatch?.[1]?.toUpperCase();
+  const classAverage = parseClassAverage($);
+  const survey = parseSurveyRequirement($);
+  if (exams.length === 0 && !instructor && !status && classAverage === void 0 && !survey) {
+    throw new ParseError("No class detail content could be parsed from class detail page.");
+  }
+  return {
+    exams,
+    students: [],
+    ...instructor ? { instructor } : {},
+    ...classAverage !== void 0 ? { classAverage } : {},
+    ...status ? { status } : {},
+    ...letterGrade ? { letterGrade } : {},
+    ...survey ? { survey } : {}
+  };
+}
+function parseSurveyPageStatus(html) {
+  if (html.includes("/Account/Login")) {
+    throw new SessionExpiredError();
+  }
+  const $ = cheerio.load(html);
+  const alertText = textOrUndefined($("div.alert").first().text());
+  if (!alertText) {
+    return void 0;
+  }
+  return {
+    message: alertText,
+    expired: /suresi dolmustur|süresi dolmuştur/i.test(alertText)
+  };
+}
+function parseStudentList(html) {
+  if (html.includes("/Account/Login")) {
+    throw new SessionExpiredError();
+  }
+  const $ = cheerio.load(html);
+  const students = [];
+  $("table.table-hover tbody tr").each((_, row) => {
+    const cells = $(row).find("td");
+    if (cells.length < 3) {
+      return;
+    }
+    const image = cells.eq(0).find("img");
+    const id = image.attr("data-user-id")?.trim();
+    if (!id) {
+      return;
+    }
+    const imageUrl = textOrUndefined(image.attr("src") ?? "");
+    const name = decodeText(cells.eq(1).text());
+    const surname = decodeText(cells.eq(2).text());
+    if (!name || !surname) {
+      return;
+    }
+    students.push({
+      id,
+      name,
+      surname,
+      ...imageUrl ? { imageUrl } : {}
+    });
+  });
+  return students;
+}
+function parseExamTable($) {
+  const tables = $("table").toArray();
+  const examTable = tables.find((table) => {
+    const headerText = $(table).find("thead").text();
+    return headerText.includes("S\u0131nav Tipi") || headerText.includes("Sinav Tipi") || headerText.includes("S\u0131nav Notu") || headerText.includes("Sinav Notu");
+  });
+  if (!examTable) {
+    return [];
+  }
+  const exams = [];
+  $(examTable).find("tbody tr").each((_, row) => {
+    const cells = $(row).find("td");
+    if (cells.length < 4) {
+      return;
+    }
+    const examType = decodeText(cells.eq(0).text());
+    const name = decodeText(cells.eq(1).text()) || examType;
+    const date = textOrUndefined(cells.eq(2).text());
+    const score = parseNumber(cells.eq(3).text());
+    const ranking = cells.length >= 6 ? textOrUndefined(cells.eq(5).text()) : void 0;
+    const average = cells.length >= 7 ? parseNumber(cells.eq(6).text()) : void 0;
+    if (!examType) {
+      return;
+    }
+    exams.push({
+      examType,
+      name,
+      ...date ? { date } : {},
+      ...score !== void 0 ? { score } : {},
+      ...average !== void 0 ? { average } : {},
+      ...ranking ? { ranking } : {}
+    });
+  });
+  return exams;
+}
+function parseInstructor($) {
+  const instructorElement = $("div.instructor").first();
+  if (instructorElement.length === 0) {
+    return void 0;
+  }
+  const name = textOrUndefined(instructorElement.find("div.name").first().text()) ?? textOrUndefined(instructorElement.find("a").first().text());
+  if (!name) {
+    return void 0;
+  }
+  const imageUrl = textOrUndefined(instructorElement.find("img").first().attr("src") ?? "");
+  return {
+    name,
+    ...imageUrl ? { imageUrl } : {}
+  };
+}
+function parseStatus($) {
+  const statusElement = $("div.success-status").first();
+  if (statusElement.length === 0) {
+    return void 0;
+  }
+  const directText = normalizeWhitespace(
+    statusElement.contents().toArray().filter((node) => node.type === "text").map((node) => node.nodeValue).join(" ")
+  );
+  if (directText) {
+    return directText;
+  }
+  const candidates = statusElement.find("span, strong, b, p, h1, h2, h3, h4, h5, h6").toArray().map((node) => normalizeWhitespace($(node).text())).filter(Boolean);
+  return candidates[0];
+}
+function parseSurveyRequirement($) {
+  const surveyLink = $("div.success-status a[href*='/MES/Application/Public/Participant']").first();
+  if (surveyLink.length === 0) {
+    return void 0;
+  }
+  const message = textOrUndefined(surveyLink.text()) ?? textOrUndefined($("div.success-status").first().text()) ?? "Survey completion is required before grades can be shown.";
+  const href = surveyLink.attr("href")?.trim();
+  return {
+    required: true,
+    message,
+    ...href ? { url: href } : {}
+  };
+}
+function parseClassAverage($) {
+  const averageSources = [
+    $("div.instructor div.avarage").first(),
+    $("div.instructor").first(),
+    $("body")
+  ];
+  for (const source of averageSources) {
+    if (source.length === 0) {
+      continue;
+    }
+    const match = normalizeWhitespace(source.text()).match(/(?:Not\s+)?Ortalamas[ıi]\s*:?\s*([\d.,]+)/i);
+    if (match?.[1]) {
+      const parsed = parseNumber(match[1]);
+      if (parsed !== void 0) {
+        return parsed;
+      }
+    }
+  }
+  return void 0;
+}
+function decodeText(value) {
+  return normalizeWhitespace(decodeHtmlEntities(value));
+}
+function textOrUndefined(value) {
+  const text = decodeText(value);
+  return text && text !== "-" ? text : void 0;
+}
+function normalizeWhitespace(value) {
+  return value.replace(/\s+/g, " ").trim();
+}
+var CLASS_ID_PATTERN = /classId=([^&'"\s]+)/;
+function parseGrades(html) {
+  if (html.includes("/Account/Login")) {
+    throw new SessionExpiredError();
+  }
+  const $ = cheerio.load(html);
+  const semesters = [];
+  $("div.panel-default").each((_, panelElement) => {
+    const panel = $(panelElement);
+    const semesterName = panel.find("div.panel-heading").first().text().trim();
+    const rows = panel.find("tbody tr").toArray();
+    if (!semesterName || rows.length === 0) {
+      return;
+    }
+    const courses = [];
+    for (let index = 0; index < rows.length; index += 1) {
+      const row = rows[index];
+      if (!row) {
+        continue;
+      }
+      const cells = $(row).find("td");
+      if (cells.length === 0 || cells.eq(0).attr("rowspan") !== "2") {
+        continue;
+      }
+      const nextRow = rows[index + 1];
+      const exams = nextRow ? parseExamRow($, nextRow) : [];
+      courses.push(parseCourseRow($, row, exams));
+      if (nextRow) {
+        index += 1;
+      }
+    }
+    if (courses.length > 0) {
+      semesters.push({
+        name: semesterName,
+        courses
+      });
+    }
+  });
+  if (semesters.length === 0) {
+    throw new ParseError("No semester grade panels could be parsed from grades page.");
+  }
+  return semesters;
+}
+function parseCourseRow($, row, exams) {
+  const cells = $(row).find("td");
+  const codeCell = cells.eq(0);
+  const nameCell = cells.eq(1);
+  const creditCell = cells.eq(2);
+  const passingGradeCell = cells.eq(6);
+  const letterGradeCell = cells.eq(7);
+  const statusCell = cells.eq(8);
+  const code = codeCell.text().trim();
+  const linkHref = codeCell.find("a").attr("href");
+  const classIdMatch = linkHref?.match(CLASS_ID_PATTERN);
+  const classId = classIdMatch?.[1] ? decodeURIComponent(classIdMatch[1]) : void 0;
+  const credit = parseNumber(creditCell.text());
+  const passingGrade = parseNumber(passingGradeCell.text());
+  const letterGrade = textOrUndefined2(letterGradeCell.text());
+  const status = textOrUndefined2(statusCell.text());
+  return {
+    code,
+    name: decodeText2(nameCell.text()),
+    ...credit !== void 0 ? { credit } : {},
+    ...passingGrade !== void 0 ? { passingGrade } : {},
+    ...letterGrade ? { letterGrade } : {},
+    ...status ? { status } : {},
+    ...classId ? { classId } : {},
+    ...exams.length > 0 ? { exams } : {}
+  };
+}
+function parseExamRow($, row) {
+  const exams = [];
+  $(row).find("td").each((_, cell) => {
+    const text = decodeText2($(cell).text());
+    if (!text) {
+      return;
+    }
+    for (const examType of ["Vize", "Final", "Butunleme", "B\xFCt\xFCnleme"]) {
+      const pattern = new RegExp(`${examType}[:\\s]*(\\d+(?:[.,]\\d+)?)`, "i");
+      const match = text.match(pattern);
+      if (!match?.[1]) {
+        continue;
+      }
+      const score = parseNumber(match[1]);
+      if (score === void 0) {
+        continue;
+      }
+      exams.push({
+        examType,
+        name: examType,
+        score
+      });
+      break;
+    }
+  });
+  return exams;
+}
+function decodeText2(value) {
+  return decodeHtmlEntities(value).trim();
+}
+function textOrUndefined2(value) {
+  const text = decodeText2(value);
+  return text || void 0;
+}
+
+// src/parsers/messages.ts
+function parseChatSearchResponse(responseBody) {
+  const raw = parsePaginatedResponse(responseBody, "chat search");
+  return {
+    pageNumber: raw.PageNumber ?? 0,
+    pageSize: raw.PageSize ?? 0,
+    totalNumberOfPages: raw.TotalNumberOfPages ?? 0,
+    totalNumberOfRecords: raw.TotalNumberOfRecords ?? 0,
+    nextPageUrl: raw.NextPageUrl ?? null,
+    items: (raw.Items ?? []).map(mapChat)
+  };
+}
+function parseChatRecipientSearchResponse(responseBody) {
+  const raw = parsePaginatedResponse(responseBody, "chat recipient search");
+  return {
+    pageNumber: raw.PageNumber ?? 0,
+    pageSize: raw.PageSize ?? 0,
+    totalNumberOfPages: raw.TotalNumberOfPages ?? 0,
+    totalNumberOfRecords: raw.TotalNumberOfRecords ?? 0,
+    nextPageUrl: raw.NextPageUrl ?? null,
+    items: (raw.Items ?? []).map((item) => mapChatRecipient(item))
+  };
+}
+function parseChatMessageSearchResponse(responseBody) {
+  const raw = parsePaginatedResponse(responseBody, "chat message search");
+  return {
+    pageNumber: raw.PageNumber ?? 0,
+    pageSize: raw.PageSize ?? 0,
+    totalNumberOfPages: raw.TotalNumberOfPages ?? 0,
+    totalNumberOfRecords: raw.TotalNumberOfRecords ?? 0,
+    nextPageUrl: raw.NextPageUrl ?? null,
+    items: (raw.Items ?? []).map((item) => mapChatMessageReceipt(item))
+  };
+}
+function parsePaginatedResponse(responseBody, context) {
+  if (responseBody.includes("/Account/Login")) {
+    throw new SessionExpiredError();
+  }
+  try {
+    return JSON.parse(responseBody);
+  } catch (error) {
+    throw new ParseError(`Failed to parse ${context} response.`, { cause: error });
+  }
+}
+function mapChat(raw) {
+  return {
+    id: raw.Id ?? "",
+    name: decodeText3(raw.Name),
+    isGroup: raw.IsGroup ?? false,
+    createdOn: raw.CreatedOn ?? "",
+    createdBy: raw.CreatedBy ?? 0,
+    ...raw.EncryptedCreatedBy !== void 0 ? { encryptedCreatedBy: raw.EncryptedCreatedBy } : {},
+    ...raw.ChatRecepientId ? { chatRecepientId: raw.ChatRecepientId } : {},
+    ...raw.LastMessageSendedOn ? { lastMessageSendedOn: raw.LastMessageSendedOn } : {},
+    ...raw.LastMessageReadedOn ? { lastMessageReadedOn: raw.LastMessageReadedOn } : {},
+    recipients: (raw.ChatRecepients ?? []).map(mapChatRecipient)
+  };
+}
+function mapChatRecipient(raw) {
+  return {
+    id: raw.Id ?? "",
+    chatId: raw.ChatId ?? "",
+    ...raw.UserEncryptId ? { userEncryptId: raw.UserEncryptId } : {},
+    userId: raw.UserId ?? 0,
+    personId: raw.PersonId ?? 0,
+    ...raw.PersonEncryptId ? { personEncryptId: raw.PersonEncryptId } : {},
+    createdOn: raw.CreatedOn ?? "",
+    createdBy: raw.CreatedBy ?? 0,
+    ...raw.EncryptedCreatedBy !== void 0 ? { encryptedCreatedBy: raw.EncryptedCreatedBy } : {},
+    ...raw.LastMessageId ? { lastMessageId: raw.LastMessageId } : {},
+    ...raw.LastMessageSendedOn ? { lastMessageSendedOn: raw.LastMessageSendedOn } : {},
+    ...raw.RecepientName ? { recipientName: decodeText3(raw.RecepientName) } : {},
+    ...raw.RecepientSurname ? { recipientSurname: decodeText3(raw.RecepientSurname) } : {},
+    chatMessages: (raw.ChatMessages ?? []).map(mapChatMessageReceipt)
+  };
+}
+function mapChatMessageReceipt(raw) {
+  return {
+    id: raw.Id ?? "",
+    chatRecepientId: raw.ChatRecepientId ?? "",
+    messageId: raw.MessageId ?? "",
+    ...raw.ReadedOn !== void 0 ? { readedOn: raw.ReadedOn } : {},
+    createdOn: raw.CreatedOn ?? "",
+    createdBy: raw.CreatedBy ?? 0,
+    ...raw.EncryptedCreatedBy !== void 0 ? { encryptedCreatedBy: raw.EncryptedCreatedBy } : {},
+    ...raw.SenderName ? { senderName: decodeText3(raw.SenderName) } : {},
+    ...raw.SenderSurname ? { senderSurname: decodeText3(raw.SenderSurname) } : {},
+    isEveryBodyReaded: raw.IsEveryBoydReaded ?? false,
+    message: mapChatMessage(raw.Message)
+  };
+}
+function mapChatMessage(raw) {
+  return {
+    id: raw?.Id ?? "",
+    ...raw?.ParentId !== void 0 ? { parentId: raw.ParentId } : {},
+    subject: decodeText3(raw?.Subject),
+    ...raw?.FileArchiveId !== void 0 ? { fileArchiveId: raw.FileArchiveId } : {},
+    createdOn: raw?.CreatedOn ?? "",
+    createdBy: raw?.CreatedBy ?? 0,
+    ...raw?.EncryptedCreatedBy !== void 0 ? { encryptedCreatedBy: raw.EncryptedCreatedBy } : {},
+    recipientReadedOnList: raw?.RecepientReadedOnList ?? {}
+  };
+}
+function decodeText3(value) {
+  return value ? decodeHtmlEntities(value).trim() : "";
+}
+var WEEKLY_SCHEDULE_PATTERN = /_weeklySchedulle\s*=\s*JSON\.parse\(Base64\.decode\(["']([^"']+)["']\)\)/;
+var GENERIC_BASE64_JSON_PATTERN = /JSON\.parse\(Base64\.decode\(["']([^"']+)["']\)\)/;
+var YEAR_PATTERN = /wcsReportYear(?:"|'|\))?[^\d]*(20\d{2})/i;
+var SEMESTER_PATTERN = /wcsReportSemester(?:"|'|\))?[^\d]*(\d{4,})/i;
+var DAY_MAP = {
+  1: "Pazartesi",
+  2: "Sali",
+  3: "Carsamba",
+  4: "Persembe",
+  5: "Cuma",
+  6: "Cumartesi",
+  7: "Pazar"
+};
+function extractWeeklyScheduleConfig(html, now = /* @__PURE__ */ new Date()) {
+  const $ = cheerio.load(html);
+  const semesterId = extractSemesterValue($, now) ?? extractInputValue($, "#wcsReportSemester") ?? html.match(SEMESTER_PATTERN)?.[1];
+  const yearValue = extractSelectValue($, "#wcsReportYear") ?? extractInputValue($, "#wcsReportYear") ?? html.match(YEAR_PATTERN)?.[1];
+  const year = yearValue ? Number(yearValue) : inferAcademicYear(now);
+  if (!semesterId) {
+    throw new ParseError("Weekly schedule semester id could not be found in dashboard HTML.");
+  }
+  if (!Number.isFinite(year)) {
+    throw new ParseError("Weekly schedule year could not be determined from dashboard HTML.");
+  }
+  return {
+    semesterId,
+    year
+  };
+}
+function buildWeeklyScheduleRequest(studentInfo, config) {
+  const program = studentInfo.Programs?.[0];
+  if (!program?.StudentId) {
+    throw new ParseError("Student program data is incomplete for weekly schedule request.");
+  }
+  return {
+    co: {
+      InstructorId: null,
+      SemesterId: config.semesterId,
+      StudentId: program.StudentId,
+      WeeklyScheduleType: 1,
+      WorkcenterId: null,
+      Year: config.year,
+      GetExamPlans: true,
+      IsAnnual: false
+    },
+    reportViewType: 0,
+    isPartial: true
+  };
+}
+function parseWeeklySchedule(responseText) {
+  if (responseText.includes("/Account/Login")) {
+    throw new SessionExpiredError();
+  }
+  const base64Value = responseText.match(WEEKLY_SCHEDULE_PATTERN)?.[1] ?? responseText.match(GENERIC_BASE64_JSON_PATTERN)?.[1];
+  if (!base64Value) {
+    throw new ParseError("Could not find weekly schedule data in response.");
+  }
+  const data = decodeBase64Json(base64Value, "weekly schedule payload");
+  const items = parseScheduleData(data);
+  if (items.length === 0) {
+    throw new ParseError("No weekly schedule items could be parsed from response.");
+  }
+  return items;
+}
+function parseScheduleData(data) {
+  if (Array.isArray(data)) {
+    return dedupeAndSort(
+      data.flatMap((entry) => {
+        if (!entry || typeof entry !== "object") {
+          return [];
+        }
+        return parseEventContainer(entry);
+      })
+    );
+  }
+  if (data && typeof data === "object" && "Days" in data) {
+    return dedupeAndSort(parseDayContainer(data));
+  }
+  return [];
+}
+function parseEventContainer(container) {
+  return (container.Events ?? []).map((event) => {
+    const courseName = normalizeText(event.CourseName ?? "");
+    if (!courseName) {
+      return null;
+    }
+    const dayIndex = event.DayOfWeek ?? 0;
+    const courseCode = extractCourseCode(courseName);
+    return {
+      day: DAY_MAP[dayIndex] ?? `Gun ${dayIndex}`,
+      startTime: formatTime(event.StartHour, event.StartMinute),
+      endTime: formatTime(event.FinishHour, event.FinishMinute),
+      courseName,
+      ...courseCode ? { courseCode } : {},
+      ...normalizeText(event.WorkCenterName ?? "") ? { classroom: normalizeText(event.WorkCenterName ?? "") } : {},
+      ...normalizeText(event.InstructorName ?? "") ? { instructor: normalizeText(event.InstructorName ?? "") } : {}
+    };
+  }).filter((item) => item !== null);
+}
+function parseDayContainer(container) {
+  return (container.Days ?? []).flatMap((day, index) => {
+    const dayName = DAY_MAP[index + 1] ?? `Gun ${index + 1}`;
+    const slots = day.Slots ?? day.slots ?? [];
+    return slots.map((slot) => {
+      const courseName = normalizeText(slot.CourseName ?? "");
+      if (!courseName) {
+        return null;
+      }
+      return {
+        day: dayName,
+        startTime: normalizeText(slot.StartTime ?? ""),
+        endTime: normalizeText(slot.EndTime ?? ""),
+        courseName,
+        ...normalizeText(slot.CourseCode ?? "") ? { courseCode: normalizeText(slot.CourseCode ?? "") } : {},
+        ...normalizeText(slot.Classroom ?? "") ? { classroom: normalizeText(slot.Classroom ?? "") } : {},
+        ...normalizeText(slot.Instructor ?? "") ? { instructor: normalizeText(slot.Instructor ?? "") } : {}
+      };
+    }).filter((item) => item !== null);
+  });
+}
+function dedupeAndSort(items) {
+  const seen = /* @__PURE__ */ new Set();
+  const uniqueItems = [];
+  for (const item of items) {
+    const key = [item.day, item.startTime, item.endTime, item.courseName].join("|");
+    if (seen.has(key)) {
+      continue;
+    }
+    seen.add(key);
+    uniqueItems.push(item);
+  }
+  return uniqueItems.sort((left, right) => {
+    const leftDay = getDayOrder(left.day);
+    const rightDay = getDayOrder(right.day);
+    if (leftDay !== rightDay) {
+      return leftDay - rightDay;
+    }
+    return left.startTime.localeCompare(right.startTime);
+  });
+}
+function extractCourseCode(courseName) {
+  const firstPart = courseName.split(" ")[0]?.trim();
+  return firstPart && firstPart.length <= 10 ? firstPart : void 0;
+}
+function formatTime(hour, minute) {
+  const safeHour = typeof hour === "number" ? hour : 0;
+  const safeMinute = typeof minute === "number" ? minute : 0;
+  return `${String(safeHour).padStart(2, "0")}:${String(safeMinute).padStart(2, "0")}`;
+}
+function getDayOrder(day) {
+  const entry = Object.entries(DAY_MAP).find(([, label]) => label === day);
+  return entry ? Number(entry[0]) : 99;
+}
+function normalizeText(value) {
+  return value.replace(/\s+/g, " ").trim();
+}
+function extractSelectValue($, selector) {
+  const select = $(selector).first();
+  if (select.length === 0) {
+    return void 0;
+  }
+  const selectedValue = select.find("option[selected]").first().attr("value")?.trim();
+  if (selectedValue) {
+    return selectedValue;
+  }
+  const firstValue = select.find("option").first().attr("value")?.trim();
+  return firstValue || void 0;
+}
+function extractSemesterValue($, now) {
+  const select = $("#wcsReportSemester").first();
+  if (select.length === 0) {
+    return void 0;
+  }
+  const selectedValue = select.find("option[selected]").first().attr("value")?.trim();
+  if (selectedValue) {
+    return selectedValue;
+  }
+  const options = select.find("option").toArray().map((option) => ({
+    value: $(option).attr("value")?.trim(),
+    label: normalizeText($(option).text()).toLowerCase()
+  }));
+  const inferredTerm = inferCurrentTerm(now);
+  const matchingOption = options.find((option) => option.value && option.label.includes(inferredTerm));
+  if (matchingOption?.value) {
+    return matchingOption.value;
+  }
+  return options[0]?.value || void 0;
+}
+function extractInputValue($, selector) {
+  const value = $(selector).first().attr("value")?.trim();
+  return value || void 0;
+}
+function inferAcademicYear(now) {
+  const year = now.getFullYear();
+  const month = now.getMonth();
+  return month >= 8 ? year : year - 1;
+}
+function inferCurrentTerm(now) {
+  const month = now.getMonth();
+  if (month >= 1 && month <= 6) {
+    return "bahar";
+  }
+  if (month === 7) {
+    return "yaz";
+  }
+  return "guz";
+}
+var TRANSCRIPT_DATA_PATTERN = /_jsm\s*=\s*JSON\.parse\(Base64\.decode\(["']([^"']+)["']\)\)/;
+function parseTranscript(html) {
+  if (html.includes("/Account/Login")) {
+    throw new SessionExpiredError();
+  }
+  const scriptMatch = html.match(TRANSCRIPT_DATA_PATTERN);
+  if (scriptMatch?.[1]) {
+    const parsed = parseTranscriptScriptPayload(scriptMatch[1]);
+    if (parsed.length > 0) {
+      return parsed;
+    }
+  }
+  const parsedFromTable = parseTranscriptTables(html);
+  if (parsedFromTable.length > 0) {
+    return parsedFromTable;
+  }
+  throw new ParseError("No transcript data could be parsed from transcript page.");
+}
+function parseTranscriptScriptPayload(base64Value) {
+  const payload = decodeBase64Json(base64Value, "transcript payload");
+  const transcript = payload.Transcripts?.[0];
+  if (!transcript?.Semesters?.length) {
+    return [];
+  }
+  return transcript.Semesters.map((semester) => ({
+    name: normalizeText2(semester.SemesterName ?? ""),
+    ...typeof semester.SemesterAverage === "number" ? { gpa: semester.SemesterAverage } : {},
+    courses: (semester.Courses ?? []).map((course) => toTranscriptCourse(course)).filter((course) => course !== null)
+  })).filter((semester) => semester.name || semester.courses.length > 0);
+}
+function parseTranscriptTables(html) {
+  const $ = cheerio.load(html);
+  const tableElements = $("table#test, table").toArray().filter((table) => $(table).find("caption").length > 0);
+  return tableElements.map((table) => {
+    const captionText = normalizeText2($(table).find("caption").first().text());
+    const rows = $(table).find("tbody tr").toArray();
+    const courses = [];
+    let gpa;
+    for (const row of rows) {
+      const cells = $(row).find("td");
+      if (cells.length < 2) {
+        continue;
+      }
+      const rowText = normalizeText2($(row).text()).toLowerCase();
+      if (rowText.includes("ortalama") || rowText.includes("gpa")) {
+        for (const cell of cells.toArray()) {
+          const parsed = parseNumber($(cell).text());
+          if (parsed !== void 0 && parsed >= 0 && parsed <= 4) {
+            gpa = parsed;
+            break;
+          }
+        }
+        continue;
+      }
+      const code = normalizeText2(cells.eq(0).text());
+      const name = normalizeText2(cells.eq(1).text());
+      const credit = cells.length > 2 ? parseNumber(cells.eq(2).text()) : void 0;
+      const letterGrade = cells.length > 3 ? textOrUndefined3(cells.eq(3).text()) : void 0;
+      if (!code && !name) {
+        continue;
+      }
+      courses.push({
+        code,
+        name,
+        ...credit !== void 0 ? { credit } : {},
+        ...letterGrade ? { letterGrade } : {}
+      });
+    }
+    if (!captionText && courses.length === 0) {
+      return null;
+    }
+    return {
+      name: captionText,
+      ...gpa !== void 0 ? { gpa } : {},
+      courses
+    };
+  }).filter((semester) => semester !== null);
+}
+function toTranscriptCourse(course) {
+  const code = normalizeText2(course.CourseCode ?? "");
+  const name = normalizeText2(course.CourseName ?? "");
+  const letterGrade = normalizeText2(course.Grade ?? "");
+  if (!code && !name) {
+    return null;
+  }
+  return {
+    code,
+    name,
+    ...typeof course.Credit === "number" ? { credit: course.Credit } : {},
+    ...letterGrade ? { letterGrade } : {}
+  };
+}
+function textOrUndefined3(value) {
+  const text = normalizeText2(value);
+  return text || void 0;
+}
+function normalizeText2(value) {
+  return decodeHtmlEntities(value).replace(/\s+/g, " ").trim();
+}
+
+// src/client.ts
+var UBYSClient = class {
+  session;
+  credentials;
+  closed = false;
+  state = {
+    authenticated: false
+  };
+  constructor(options = {}) {
+    this.session = new UBYSSession(options);
+    this.credentials = {
+      username: options.username,
+      password: options.password
+    };
+  }
+  get isLoggedIn() {
+    return this.state.authenticated;
+  }
+  get isClosed() {
+    return this.closed;
+  }
+  async login(username = this.credentials.username, password = this.credentials.password) {
+    if (!username || !password) {
+      throw new SessionExpiredError("Username and password are required for login.", {
+        code: "MISSING_CREDENTIALS"
+      });
+    }
+    const login = await loginWithCredentials(this.session, username, password);
+    const dashboardHtml = await this.fetchDashboardHtml();
+    const studentInfo = extractStudentInfo(dashboardHtml);
+    const sapId = extractSapId(dashboardHtml);
+    const profile = toUserProfile(username, studentInfo, sapId, login.longUsername?.trim());
+    this.credentials.username = username;
+    this.credentials.password = password;
+    this.state = {
+      authenticated: true,
+      studentNumber: username,
+      login,
+      dashboardHtml,
+      studentInfo,
+      profile,
+      ...sapId ? { sapId } : {}
+    };
+  }
+  async getProfile() {
+    this.ensureAuthenticated();
+    if (this.state.profile) {
+      return this.state.profile;
+    }
+    const dashboardHtml = await this.fetchDashboardHtml();
+    const studentInfo = extractStudentInfo(dashboardHtml);
+    const sapId = extractSapId(dashboardHtml);
+    const profile = toUserProfile(this.state.studentNumber ?? "", studentInfo, sapId, this.state.login?.longUsername?.trim());
+    this.state.dashboardHtml = dashboardHtml;
+    this.state.studentInfo = studentInfo;
+    if (sapId) {
+      this.state.sapId = sapId;
+    } else {
+      delete this.state.sapId;
+    }
+    this.state.profile = profile;
+    return profile;
+  }
+  async getAdvisor() {
+    this.ensureAuthenticated();
+    if (!this.state.sapId) {
+      await this.getProfile();
+    }
+    if (!this.state.sapId) {
+      return null;
+    }
+    const response = await this.session.get("AIS/Student/Home/AdvisorInfo", {
+      searchParams: {
+        sapId: this.state.sapId
+      },
+      headers: {
+        ...AJAX_HEADERS
+      }
+    });
+    this.session.assertOk(response);
+    this.session.assertNotLoginRedirect(response);
+    return parseAdvisor(response.body);
+  }
+  async getCafeteriaMenu() {
+    const response = await this.session.get(OMU_CAFETERIA_URL, {
+      https: {
+        rejectUnauthorized: false
+      }
+    });
+    this.session.assertOk(response);
+    return parseCafeteriaMenu(response.body);
+  }
+  async getMessages(options = {}) {
+    this.ensureAuthenticated();
+    const response = await this.session.post("Conversation/SearchChat", {
+      json: {
+        Keyword: options.keyword ?? "",
+        PageNumber: options.pageNumber ?? 0,
+        PageSize: options.pageSize ?? 10
+      },
+      headers: {
+        ...AJAX_HEADERS,
+        origin: this.session.baseUrl,
+        referer: `${this.session.baseUrl}/Conversation/Index`
+      }
+    });
+    this.session.assertOk(response);
+    this.session.assertNotLoginRedirect(response);
+    return parseChatSearchResponse(response.body);
+  }
+  async getChatRecipients(options) {
+    this.ensureAuthenticated();
+    const response = await this.session.post("Conversation/SearchChatRecepient", {
+      json: {
+        ChatIds: options.chatIds,
+        PageNumber: options.pageNumber ?? 0,
+        PageSize: options.pageSize ?? 20
+      },
+      headers: {
+        ...AJAX_HEADERS,
+        origin: this.session.baseUrl,
+        referer: `${this.session.baseUrl}/Conversation/Index`
+      }
+    });
+    this.session.assertOk(response);
+    this.session.assertNotLoginRedirect(response);
+    return parseChatRecipientSearchResponse(response.body);
+  }
+  async getChatMessages(options) {
+    this.ensureAuthenticated();
+    const response = await this.session.post("Conversation/SearchChatMessage", {
+      json: {
+        ChatRecepientIds: options.chatRecepientIds,
+        Keyword: options.keyword ?? "",
+        PageNumber: options.pageNumber ?? 0,
+        PageSize: options.pageSize ?? 50
+      },
+      headers: {
+        ...AJAX_HEADERS,
+        origin: this.session.baseUrl,
+        referer: `${this.session.baseUrl}/Conversation/Index`
+      }
+    });
+    this.session.assertOk(response);
+    this.session.assertNotLoginRedirect(response);
+    return parseChatMessageSearchResponse(response.body);
+  }
+  async getGrades() {
+    this.ensureAuthenticated();
+    if (!this.state.sapId) {
+      await this.getProfile();
+    }
+    const response = await this.session.get("AIS/Student/Class/Index", {
+      searchParams: {
+        history: "true",
+        ...this.state.sapId ? { sapid: this.state.sapId } : {}
+      }
+    });
+    this.session.assertOk(response);
+    this.session.assertNotLoginRedirect(response);
+    return parseGrades(response.body);
+  }
+  async getClassDetails(classId) {
+    this.ensureAuthenticated();
+    const detailResponse = await this.session.get("AIS/Student/Class/ClassDetail", {
+      searchParams: {
+        classId
+      }
+    });
+    this.session.assertOk(detailResponse);
+    this.session.assertNotLoginRedirect(detailResponse);
+    const detail = parseClassDetail(detailResponse.body);
+    if (detail.survey?.required && detail.survey.url) {
+      try {
+        const surveyResponse = await this.session.get(detail.survey.url.replace(/^\//, ""));
+        this.session.assertNotLoginRedirect(surveyResponse);
+        if (surveyResponse.statusCode === 200) {
+          const surveyStatus = parseSurveyPageStatus(surveyResponse.body);
+          if (surveyStatus) {
+            detail.survey = {
+              ...detail.survey,
+              ...surveyStatus
+            };
+          }
+        }
+      } catch (error) {
+        if (!isBestEffortClassDetailError(error)) {
+          throw error;
+        }
+      }
+    }
+    try {
+      const studentResponse = await this.session.get("AIS/Student/Class/CourseStudents", {
+        searchParams: {
+          classId
+        }
+      });
+      this.session.assertNotLoginRedirect(studentResponse);
+      if (studentResponse.statusCode === 200) {
+        const students = parseStudentList(studentResponse.body);
+        if (students.length > 0) {
+          return {
+            ...detail,
+            students
+          };
+        }
+      }
+    } catch (error) {
+      if (!isBestEffortClassDetailError(error)) {
+        throw error;
+      }
+      return detail;
+    }
+    return detail;
+  }
+  async getTranscript() {
+    this.ensureAuthenticated();
+    if (!this.state.dashboardHtml) {
+      this.state.dashboardHtml = await this.fetchDashboardHtml();
+    }
+    if (!this.state.sapId) {
+      const sapId = extractSapId(this.state.dashboardHtml);
+      if (sapId) {
+        this.state.sapId = sapId;
+      }
+    }
+    const transcriptPath = this.resolveTranscriptPath(this.state.dashboardHtml, this.state.sapId);
+    const response = await this.session.get(transcriptPath);
+    this.session.assertOk(response);
+    this.session.assertNotLoginRedirect(response);
+    return parseTranscript(response.body);
+  }
+  async getWeeklySchedule() {
+    this.ensureAuthenticated();
+    if (!this.state.studentInfo) {
+      await this.getProfile();
+    }
+    if (!this.state.studentInfo) {
+      throw new NotImplementedUBYSError("Student info is not available for `getWeeklySchedule()`. Try logging in again.");
+    }
+    if (!this.state.dashboardHtml) {
+      this.state.dashboardHtml = await this.fetchDashboardHtml();
+    }
+    const scheduleConfig = extractWeeklyScheduleConfig(this.state.dashboardHtml);
+    const payload = buildWeeklyScheduleRequest(this.state.studentInfo, scheduleConfig);
+    const response = await this.session.post("AIS/Student/Home/GetWeeklySchedule", {
+      json: payload,
+      headers: {
+        ...AJAX_HEADERS
+      }
+    });
+    this.session.assertOk(response);
+    this.session.assertNotLoginRedirect(response);
+    return parseWeeklySchedule(response.body);
+  }
+  clearSession() {
+    this.ensureOpen();
+    this.state = {
+      authenticated: false
+    };
+  }
+  async close() {
+    if (this.closed) {
+      return;
+    }
+    this.state = {
+      authenticated: false
+    };
+    this.closed = true;
+    await this.session.close();
+  }
+  ensureAuthenticated() {
+    this.ensureOpen();
+    if (!this.state.authenticated) {
+      throw new SessionExpiredError("Not logged in. Call `login()` first.");
+    }
+  }
+  ensureOpen() {
+    if (this.closed || this.session.isClosed) {
+      throw new ClientClosedError();
+    }
+  }
+  async fetchDashboardHtml() {
+    const response = await this.session.get("AIS/Student/Home/Index");
+    this.session.assertOk(response);
+    this.session.assertNotLoginRedirect(response);
+    return response.body;
+  }
+  resolveTranscriptPath(dashboardHtml, sapId) {
+    if (dashboardHtml) {
+      const $ = cheerio.load(dashboardHtml);
+      const href = $("a[href*='/AIS/Student/Transcript/Index']").first().attr("href");
+      if (href) {
+        return href.replace(/&amp;/g, "&").replace(/^\//, "");
+      }
+    }
+    return sapId ? `AIS/Student/Transcript/Index?sapId=${encodeURIComponent(sapId)}` : "AIS/Student/Transcript/Index";
+  }
+};
+function isBestEffortClassDetailError(error) {
+  return error instanceof HttpError || error instanceof NetworkError || error instanceof ParseError;
+}
+
+exports.AuthenticationError = AuthenticationError;
+exports.ClientClosedError = ClientClosedError;
+exports.HttpError = HttpError;
+exports.LoginError = LoginError;
+exports.NetworkError = NetworkError;
+exports.NotImplementedUBYSError = NotImplementedUBYSError;
+exports.ParseError = ParseError;
+exports.SessionExpiredError = SessionExpiredError;
+exports.UBYSClient = UBYSClient;
+exports.UBYSError = UBYSError;
+//# sourceMappingURL=index.cjs.map
+//# sourceMappingURL=index.cjs.map