@wilm-ai/wilma-client 1.7.1 → 1.8.0

package/dist/client.d.ts

@@ -94,6 +94,11 @@ export declare class WilmaClient {
     };
     news: {
         list: () => Promise<NewsItem[]>;
+        /**
+         * The bulletins, or null when this Wilma doesn't show them to this account: it answers /news with 403 (Helsinki's
+         * does, for a guardian) or 404 while the session is alive. Its other pages read as usual.
+         */
+        listIfShown: () => Promise<NewsItem[] | null>;
         get: (newsId: number) => Promise<NewsItem>;
         fetchResource: (newsId: number, resourceId: string, options?: {
             item?: NewsItem;

package/dist/client.js

@@ -241,6 +241,20 @@ export class WilmaClient {
             }
             return parseNewsListHtml(text);
         },
+        /**
+         * The bulletins, or null when this Wilma doesn't show them to this account: it answers /news with 403 (Helsinki's
+         * does, for a guardian) or 404 while the session is alive. Its other pages read as usual.
+         */
+        listIfShown: async () => {
+            try {
+                return await this.news.list();
+            }
+            catch (err) {
+                if (err instanceof APIError && (err.status === 403 || err.status === 404))
+                    return null;
+                throw err;
+            }
+        },
         get: async (newsId) => {
             const resp = await this.session.get(`/news/${newsId}`);
             const contentType = resp.headers.get("content-type")?.toLowerCase() ?? "";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@wilm-ai/wilma-client",
-  "version": "1.7.1",
+  "version": "1.8.0",
   "description": "Unofficial client for Wilma, the Finnish school information system: login (with two-step verification), schedule, homework, exams, messages and news.",
   "license": "MIT",
   "repository": {