@insignia-education/api-sdk-js 0.24.0 → 0.24.2

package/package.json

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

package/src/api/v1/Admin.js

@@ -28,6 +28,31 @@ 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');
+    }
+
+    /** Average + count of the course survey ratings — `{ teacher, content, platform, ux, overall }`, each `{ average, count }` (`average` is `null` when nobody rated it). Counts are enrollments that answered that rating; `overall.average` spans every rating given and `overall.count` is enrollments with at least one. Teacher enrollments and deleted ones are excluded. */
+    statisticsCourseRatings() {
+        return this.#client.get('/admin/statistics/course-ratings');
+    }
+
     /** 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/Sales.js

@@ -16,6 +16,11 @@ export default class Sales {
         return this.#client.get('/sales/my-sales', { page, per_page: perPage });
     }
 
+    /** Paginated list of the current seller's clients — users whose `seller_id` is the seller (`id, name, username, email, phone, created_at`). */
+    myClients({ page, perPage } = {}) {
+        return this.#client.get('/sales/my-clients', { page, per_page: perPage });
+    }
+
     /** Sellers and above: users with all 3 KYC files uploaded but not yet verified. */
     kycPending() { return this.#client.get('/sales/kyc-pending'); }