@insignia-education/api-sdk-js 0.15.88 → 0.15.94

package/package.json

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

package/src/Client.js

@@ -127,5 +127,5 @@ export default class InsigniaClient {
     post(path, body = null) { return this.#request('POST',   path, body); }
     put(path, body = null)  { return this.#request('PUT',    path, body); }
     patch(path, body = null){ return this.#request('PATCH',  path, body); }
-    del(path)               { return this.#request('DELETE', path); }
+    del(path, body = null)  { return this.#request('DELETE', path, body); }
 }

package/src/api/v1/Admin.js

@@ -15,6 +15,11 @@ export default class Admin {
         return this.#client.get('/admin/statistics/sales', { from_date: fromDate, to_date: toDate });
     }
 
+    /** 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 });
+    }
+
     /** Paginated sales-report rows for a date range, with optional course/seller/payment-method/currency filters. */
     reportsSales({ fromDate, toDate, courseId, sellerId, paymentMethodId, currencyId, page, perPage } = {}) {
         return this.#client.get('/admin/reports/sales', {

package/src/api/v1/Auth.js

@@ -21,4 +21,6 @@ export default class Auth {
     emailVerify(data)           { return this.#client.post('/auth/email-verify', data); }
     /** Second login step when two_factor_required: exchange { pin } for a session. */
     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}`); }
 }

package/src/api/v1/Blocks.js

@@ -0,0 +1,12 @@
+/** Admin-only: IP blocks (the blocks table — ip-scoped only, see App\Models\Block). */
+export default class Blocks {
+    #client;
+
+    constructor(client) {
+        this.#client = client;
+    }
+
+    get(id = null)  { return id ? this.#client.get(`/blocks/${id}`) : this.#client.get('/blocks'); }
+    create(data)    { return this.#client.put('/blocks', data); }
+    delete(id)      { return this.#client.del(`/blocks/${id}`); }
+}

package/src/api/v1/Teacher.js

@@ -60,8 +60,8 @@ export default class Teacher {
             courseDateGradedQuizzes: (courseDateId, quizId = null) => this.#client.get(`${base}/course-dates/${courseDateId}/quizzes/graded`, quizId ? { quiz_id: quizId } : {}),
             /** Distinct { id, title } quizzes needing correction under this CourseDate's course — for the graded-tab quiz filter. */
             courseDateCorrectableQuizzes: (courseDateId) => this.#client.get(`${base}/course-dates/${courseDateId}/quizzes/correctable`),
-            /** Ungraded quiz submissions grouped by course, for every course this teacher teaches. */
-            ungradedQuizzes: () => this.#client.get(`${base}/quizzes/ungraded`),
+            /** Ungraded quiz submissions grouped by course, for every course this teacher teaches. hasCertificate (true/false) narrows to courses with/without Course.certificate_exam_enabled; omit for every course. */
+            ungradedQuizzes: (hasCertificate = null) => this.#client.get(`${base}/quizzes/ungraded`, hasCertificate === null ? {} : { has_certificate: hasCertificate ? 1 : 0 }),
             /** Ungraded quiz submissions for one course (any student, not just one CourseDate's) — for courses with no cohort scheduling, e.g. placement exams. */
             courseUngradedQuizzes: (courseId) => this.#client.get(`${base}/courses/${courseId}/quizzes/ungraded`),
             /** Already-graded quiz submissions for one course, optionally narrowed to one quiz. */

package/src/api/v1/Users.js

@@ -217,6 +217,18 @@ export default class Users {
     /** Sales-and-above: re-run the course/individual-session access reconciliation for this user on demand. */
     syncAccess(userId) { return this.#client.post(`/users/${userId}/sync-access`); }
 
+    /** Admin-only: total blockade — enforced on every authenticated route, not just new logins. */
+    block(userId, reason) { return this.#client.post(`/users/${userId}/block`, { reason }); }
+
+    /** Admin-only: lifts a hard block. */
+    unblock(userId) { return this.#client.post(`/users/${userId}/unblock`); }
+
+    /** GDPR erasure request — self-service or sales-and-above, always confirmed with the ACTOR's own current password. Soft-deletes now; the API permanently purges it after a 1-year retention window. */
+    delete(userId, password) { return this.#client.del(`/users/${userId}`, { password }); }
+
+    /** GDPR access/portability request (Art. 15/20) — self-service or sales-and-above. Runs synchronously and returns the DataRequest with `pdf_url`/`json_url` already populated. */
+    exportData(userId) { return this.#client.post(`/users/${userId}/data-export`); }
+
     /** Notifications are created by internal services, not over the API — `resend()` is the one exception (sales-and-above). */
     notifications(userId) {
         const base = `/users/${userId}/notifications`;

package/src/api/v1/index.js

@@ -19,6 +19,7 @@ import Forums from './Forums.js';
 import Hashes from './Hashes.js';
 import Insignias from './Insignias.js';
 import Languages from './Languages.js';
+import Blocks from './Blocks.js';
 import MailBlacklist from './MailBlacklist.js';
 import MailingLists from './MailingLists.js';
 import Offers from './Offers.js';
@@ -75,6 +76,7 @@ export default class InsigniaApiV1 extends InsigniaApi {
         this.insignias            = new Insignias(this);
         this.languages            = new Languages(this);
         this.mailBlacklist        = new MailBlacklist(this);
+        this.blocks               = new Blocks(this);
         this.mailingLists         = new MailingLists(this);
         this.offers               = new Offers(this);
         this.organizations        = new Organizations(this);