@insignia-education/api-sdk-js 0.23.0 → 0.24.1

package/package.json

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

package/src/api/v1/Admin.js

@@ -28,6 +28,26 @@ export default class Admin {
         return this.#client.get('/admin/statistics/sales', { from_date: fromDate, to_date: toDate });
     }
 
+    /** Enrolled (non-teacher) students per course, biggest first — `[{ course_id, title, students }]`. Courses with no students are omitted. */
+    statisticsStudentsByCourse() {
+        return this.#client.get('/admin/statistics/students-by-course');
+    }
+
+    /** Enrolled students per birth country, biggest first — `[{ country_id, title, cod, students }]`. Students with no birth country set share one row with `country_id: null`. */
+    statisticsStudentsByBirthCountry() {
+        return this.#client.get('/admin/statistics/students-by-birth-country');
+    }
+
+    /** Same as statisticsStudentsByBirthCountry(), grouped by the students' current country instead. */
+    statisticsStudentsByCurrentCountry() {
+        return this.#client.get('/admin/statistics/students-by-current-country');
+    }
+
+    /** Enrolled students per age group (whole years as of today) — always all eight groups, in order, zero-filled: `[{ group: '0-17' | '18-24' | '25-34' | '35-44' | '45-54' | '55-64' | '65+' | 'unknown', students }]`. `unknown` = no birth date. */
+    statisticsStudentsByAgeGroup() {
+        return this.#client.get('/admin/statistics/students-by-age-group');
+    }
+
     /** Claude (Anthropic) token usage/spend for a date range, plus account balance. Each half resolves `{ available: false }` (not an error) when its required config (admin key / account balance) isn't set. */
     statisticsClaudeUsage({ fromDate, toDate } = {}) {
         return this.#client.get('/admin/statistics/claude-usage', { from_date: fromDate, to_date: toDate });

package/src/api/v1/Users.js

@@ -226,6 +226,24 @@ export default class Users {
         };
     }
 
+    /**
+     * Guided-tutorial status per user. Each tutorial is identified by a code
+     * (e.g. "dashboard-student") and is `pending` until the user finishes or skips
+     * it, then `viewed` — so the front can avoid showing the same tour twice.
+     */
+    tutorials(userId) {
+        const base = `/users/${userId}/tutorials`;
+        const client = this.#client;
+        return {
+            /** Every known tutorial code with its status: [{ code, status, viewed_at }]. */
+            get: () => client.get(base),
+            /** One tutorial's { code, status: 'pending'|'viewed', viewed_at }. Unknown code → 404. */
+            status: (code) => client.get(`${base}/${code}`),
+            /** Mark a tutorial as viewed (idempotent). Unknown code → 404. */
+            markViewed: (code) => client.post(`${base}/${code}/viewed`),
+        };
+    }
+
     experiences(userId) {
         const base = `/users/${userId}/experiences`;
         const client = this.#client;