@insignia-education/api-sdk-js 0.15.95 → 0.15.97

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@insignia-education/api-sdk-js",
-  "version": "0.15.95",
+  "version": "0.15.97",
   "description": "JavaScript SDK for the Insignia Education API",
   "main": "index.js",
   "type": "module",

package/src/api/v1/Admin.js

@@ -55,6 +55,20 @@ export default class Admin {
         });
     }
 
+    /** Paginated per-teacher report for a date range: hours given, sessions given, absences (substituted out) and substitutions (covered for someone else). */
+    reportsTeacherStats({ fromDate, toDate, page, perPage } = {}) {
+        return this.#client.get('/admin/reports/teacher-stats', {
+            from_date: fromDate, to_date: toDate, page, per_page: perPage,
+        });
+    }
+
+    /** Direct download link for the teacher-stats report (format: 'csv' | 'xlsx'). */
+    reportsTeacherStatsExportUrl({ fromDate, toDate, format = 'csv' } = {}) {
+        return Admin.#buildUrl(this.#client.baseUrl, '/admin/reports/teacher-stats/export', {
+            from_date: fromDate, to_date: toDate, format,
+        });
+    }
+
     static #buildUrl(baseUrl, path, params) {
         const qs = new URLSearchParams(
             Object.entries(params).filter(([, v]) => v !== undefined && v !== null && v !== '')

package/src/api/v1/Auth.js

@@ -23,4 +23,8 @@ export default class Auth {
     twoFactor(data)             { return this.#client.post('/auth/2fa', data); }
     /** GDPR Art. 8 — clicked by the guardian from the consent email, not the account holder; no session is created. */
     guardianConsentConfirm(hash) { return this.#client.post(`/guardian-consent/${hash}`); }
+    /** GDPR Art. 8 — a blocked minor (user.guardian_consent_required) submits their guardian's
+     *  email from the dashboard gate; exempted from the guardian-consent block server-side so
+     *  it's reachable even while everything else 403s. */
+    submitGuardianEmail(email)  { return this.#client.post('/auth/guardian-email', { email }); }
 }