finki-auth 1.7.0 → 1.9.0

package/README.md

@@ -1,6 +1,6 @@
 # FINKI Auth
 
-NPM (Node) package for managing authentication and sessions for FCSE CAS and the other services. Uses an HTTP client under the hood, and not a full browser (such as Puppeteer).
+Node.js package for managing authentication and cookies for FCSE's services, built using [axios](https://github.com/axios/axios).
 
 ## Features
 
@@ -21,16 +21,43 @@ You can add the package to your NPM project by running `npm i finki-auth`.
 ## Example
 
 ```ts
-import { CasAuthentication, Service } from "finki-auth";
+import {
+  CasAuthentication,
+  Service,
+  isCookieValid,
+  isCookieHeaderValid,
+} from "finki-auth";
 
-const auth = new CasAuthentication(credentials.username, credentials.password);
-const rawCookies = await auth.authenticate(Service.COURSES);
+const credentials = {
+  username: "example",
+  password: "secret_password",
+};
 
-const cookies: Record<string, string> = {};
+const auth = new CasAuthentication(credentials);
 
-for (const { key, value } of rawCookies) {
-  cookies[key] = value;
-}
+await auth.authenticate(Service.COURSES);
+
+// Get array of cookie objects
+const cookies = await auth.getCookie(Service.COURSES);
+
+// Get cookie header directly for sending requests
+const cookieHeader = await auth.buildCookieHeader(Service.COURSES);
+
+// Check if the cookie is still valid, and if not, call `authenticate` again
+const isCookieValid = await auth.isCookieValid(Service.COURSES);
+
+if (!isCookieValid) await auth.authenticate(Service.COURSES);
+
+// There are also some utility functions available:
+const isCookieValidStandalone = await isCookieValid({
+  service: Service.COURSES,
+  cookies,
+});
+
+const isCookieHeaderValidStandalone = await isCookieHeaderValid({
+  service: Service.COURSES,
+  cookieHeader,
+});
 ```
 
 ## License

package/dist/authentication.d.ts

@@ -3,9 +3,12 @@ export declare class CasAuthentication {
     private readonly password;
     private readonly session;
     private readonly username;
-    constructor(username: string, password: string);
+    constructor({ password, username }: {
+        password: string;
+        username: string;
+    });
     private static readonly getFullLoginUrl;
-    authenticate: (service: Service) => Promise<void>;
+    readonly authenticate: (service: Service) => Promise<void>;
     readonly buildCookieHeader: (service: Service) => Promise<string>;
     readonly getCookie: (service: Service) => Promise<import("tough-cookie").Cookie[]>;
     readonly isCookieValid: (service: Service) => Promise<boolean>;

package/dist/authentication.js

@@ -3,13 +3,14 @@ import { wrapper } from 'axios-cookiejar-support';
 import { JSDOM } from 'jsdom';
 import { CookieJar } from 'tough-cookie';
 import { z } from 'zod';
-import { SERVICE_LOGIN_URLS, SERVICE_SUCCESS_SELECTORS, SERVICE_URLS, } from './constants.js';
+import { SERVICE_LOGIN_URLS, SERVICE_URLS } from './constants.js';
 import { Service } from './lib/Service.js';
+import { getCookieValidity } from './utils.js';
 export class CasAuthentication {
     password;
     session;
     username;
-    constructor(username, password) {
+    constructor({ password, username }) {
         this.username = username;
         this.password = password;
         const cookieJar = new CookieJar();
@@ -48,24 +49,12 @@ export class CasAuthentication {
     };
     isCookieValid = async (service) => {
         const url = SERVICE_URLS[service];
-        const userElementSelector = SERVICE_SUCCESS_SELECTORS[service];
         const cookies = await this.getCookie(service);
         const jar = new CookieJar();
         for (const cookie of cookies) {
             await jar.setCookie(cookie, url);
         }
-        const client = wrapper(axios.create({ jar }));
-        const response = await client.get(url);
-        const html = z.string().parse(response.data);
-        const { window } = new JSDOM(html);
-        const userElement = window.document.querySelector(userElementSelector);
-        switch (userElement?.textContent) {
-            case undefined:
-            case 'Најава':
-                return false;
-            default:
-                return true;
-        }
+        return await getCookieValidity({ cookieJar: jar, service });
     };
     getFormData = (inputs) => {
         const urlSearchParams = new URLSearchParams();

package/dist/index.d.ts

@@ -1,2 +1,3 @@
 export { CasAuthentication } from './authentication.js';
 export { Service } from './lib/Service.js';
+export { isCookieHeaderValid, isCookieValid } from './utils.js';

package/dist/index.js

@@ -1,2 +1,3 @@
 export { CasAuthentication } from './authentication.js';
 export { Service } from './lib/Service.js';
+export { isCookieHeaderValid, isCookieValid } from './utils.js';

package/dist/utils.d.ts

@@ -0,0 +1,14 @@
+import { type Cookie, CookieJar } from 'tough-cookie';
+import type { Service } from './lib/Service.js';
+export declare const getCookieValidity: ({ cookieJar, service, }: {
+    cookieJar: CookieJar;
+    service: Service;
+}) => Promise<boolean>;
+export declare const isCookieValid: ({ cookies, service, }: {
+    cookies: Cookie[];
+    service: Service;
+}) => Promise<boolean>;
+export declare const isCookieHeaderValid: ({ cookieHeader, service, }: {
+    cookieHeader: string;
+    service: Service;
+}) => Promise<boolean>;

package/dist/utils.js

@@ -0,0 +1,45 @@
+import axios from 'axios';
+import { wrapper } from 'axios-cookiejar-support';
+import { JSDOM } from 'jsdom';
+import { CookieJar } from 'tough-cookie';
+import z from 'zod';
+import { SERVICE_SUCCESS_SELECTORS, SERVICE_URLS } from './constants.js';
+export const getCookieValidity = async ({ cookieJar, service, }) => {
+    const url = SERVICE_URLS[service];
+    const userElementSelector = SERVICE_SUCCESS_SELECTORS[service];
+    const client = wrapper(axios.create({ jar: cookieJar }));
+    const response = await client.get(url);
+    const html = z.string().parse(response.data);
+    const { window } = new JSDOM(html);
+    const userElement = window.document.querySelector(userElementSelector);
+    switch (userElement?.textContent) {
+        case undefined:
+        case 'Најава':
+            return false;
+        default:
+            return true;
+    }
+};
+export const isCookieValid = async ({ cookies, service, }) => {
+    const url = SERVICE_URLS[service];
+    const jar = new CookieJar();
+    for (const cookie of cookies) {
+        await jar.setCookie(cookie, url);
+    }
+    return getCookieValidity({ cookieJar: jar, service });
+};
+export const isCookieHeaderValid = async ({ cookieHeader, service, }) => {
+    const url = SERVICE_URLS[service];
+    const jar = new CookieJar();
+    const cookies = cookieHeader
+        ? cookieHeader.split('; ').map((cookie) => {
+            const [key, ...valParts] = cookie.split('=');
+            const value = valParts.join('=');
+            return { key, value };
+        })
+        : [];
+    for (const { key, value } of cookies) {
+        await jar.setCookie(`${key}=${value}`, url);
+    }
+    return getCookieValidity({ cookieJar: jar, service });
+};

package/package.json

@@ -13,29 +13,27 @@
     }
   },
   "dependencies": {
-    "axios": "^1.12.2",
-    "axios-cookiejar-support": "^6.0.4",
-    "jsdom": "^27.0.0",
+    "axios": "^1.13.2",
+    "axios-cookiejar-support": "^6.0.5",
+    "jsdom": "^27.4.0",
     "tough-cookie": "^6.0.0",
-    "zod": "^4.1.12"
+    "zod": "^4.3.2"
   },
   "description": "Authentication for FCSE services",
   "devDependencies": {
-    "@commitlint/cli": "^20.1.0",
-    "@commitlint/config-conventional": "^20.0.0",
-    "@semantic-release/changelog": "^6.0.3",
-    "@semantic-release/git": "^10.0.1",
+    "@commitlint/cli": "^20.2.0",
+    "@commitlint/config-conventional": "^20.2.0",
     "@types/jsdom": "^27.0.0",
     "commitizen": "^4.3.1",
     "cz-conventional-changelog": "^3.3.0",
     "dotenv": "^17.2.3",
-    "eslint": "^9.37.0",
-    "eslint-config-imperium": "^2.7.0",
+    "eslint": "^9.39.2",
+    "eslint-config-imperium": "^3.1.0",
     "husky": "^9.1.7",
-    "rimraf": "^6.0.1",
-    "semantic-release": "^24.2.9",
+    "rimraf": "^6.1.2",
+    "semantic-release": "^25.0.2",
     "typescript": "~5.9.3",
-    "vitest": "^3.2.4"
+    "vitest": "^4.0.16"
   },
   "engines": {
     "node": "^20 || ^22 || ^24"
@@ -63,7 +61,7 @@
     "commit": "cz",
     "commitlint": "commitlint --edit",
     "format": "eslint --ignore-pattern \"**/test/*\" --fix .",
-    "lint": "eslint . --ignore-pattern \"**/test/*\" --no-warn-ignored --cache",
+    "lint": "tsc --noEmit && eslint . --ignore-pattern \"**/test/*\" --no-warn-ignored --cache",
     "prepare": "husky",
     "package": "npm run build && npm pack",
     "release": "npm run build && semantic-release",
@@ -72,5 +70,5 @@
   },
   "type": "module",
   "types": "dist/index.d.ts",
-  "version": "1.7.0"
+  "version": "1.9.0"
 }