@insignia-education/api-sdk-js 0.15.53 → 0.15.55

package/.nvmrc

@@ -1 +1 @@
-24
+25

package/AGENTS.md

@@ -87,11 +87,25 @@ The SDK is language-neutral — it must never contain human-readable strings.
 - Removed endpoint → remove or deprecate the corresponding SDK method
 - Never leave the SDK behind the API; the `front` repo relies solely on this SDK
 
+## Consumption — never symlink
+
+Consumers (`front`, `api`) must install this package the normal npm way — **never** via a symlink
+(`npm link`, a manual `ln -s` into a consumer's `node_modules`, etc.), even for local iteration.
+
+- A symlinked package looks like it works, but an `npm install`/`npm ci` in the consumer repo can
+  silently replace the link with a stale registry copy — the consumer keeps running old SDK code
+  with no error, and edits stop propagating until someone notices at runtime.
+- Instead: bump this package's version (`npm version patch|minor`) and have the human publish it
+  (`npm publish`), then bump the version range in the consumer's `package.json` and run
+  `npm install` there.
+- Never publish on your own initiative — publishing is a human action.
+
 ## Never do
 - Don't add runtime dependencies
 - Don't change the constructor signature of `InsigniaApiV1`
 - Don't hardcode API base URLs — always receive from constructor
 - Don't let the SDK lag behind `api` — update both in the same task
+- Don't symlink this package into a consumer's `node_modules` — publish it instead
 
 
 ---

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@insignia-education/api-sdk-js",
-  "version": "0.15.53",
+  "version": "0.15.55",
   "description": "JavaScript SDK for the Insignia Education API",
   "main": "index.js",
   "type": "module",
@@ -20,7 +20,7 @@
   "author": "Insignia Education",
   "license": "MIT",
   "engines": {
-    "node": ">=24"
+    "node": ">=25"
   },
   "bugs": {
     "url": "https://github.com/insignia-education/api-sdk-js/issues"

package/src/api/v1/Employee.js

@@ -10,8 +10,8 @@ export default class Employee {
         return {
             /** All teachers' sessions for a given date (YYYY-MM-DD). */
             sessions: (date) => this.#client.get(`${base}/sessions`, { date }),
-            /** All teachers' individual sessions for the 7-day window starting at `start` (YYYY-MM-DD, Monday). */
-            weekSessions: (start) => this.#client.get(`${base}/sessions/week`, { start }),
+            /** Every teacher's recurring weekly availability for individual sessions (day-of-week templates, not booked dates). */
+            individualAvailability: () => this.#client.get(`${base}/teachers/individual-availability`),
             /** All sessions for one course_date, any teacher. */
             courseDateSessions: (courseDateId) => this.#client.get(`${base}/course-dates/${courseDateId}/sessions`),
             /** Mark a student's attendance on any teacher's session. */

package/src/api/v1/Users.js

@@ -47,8 +47,31 @@ export default class Users {
         };
     }
     courseNotes(userId)    { return this.#nested(userId, 'course-notes'); }
-    quizzes(userId)        { return this.#nested(userId, 'quizzes'); }
-    sessions(userId)       { return this.#nested(userId, 'sessions'); }
+
+    /** get() accepts an optional { courseId } filter to narrow to a single course. */
+    quizzes(userId) {
+        const base = `/users/${userId}/quizzes`;
+        const client = this.#client;
+        return {
+            get:    (id = null, { courseId } = {}) => id ? client.get(`${base}/${id}`) : client.get(courseId ? `${base}?course_id=${courseId}` : base),
+            create: (data)      => client.put(base, data),
+            edit:   (id, data)  => client.patch(`${base}/${id}`, data),
+            delete: (id)        => client.del(`${base}/${id}`),
+        };
+    }
+
+    /** get() accepts an optional { courseId } filter to narrow to a single course. */
+    sessions(userId) {
+        const base = `/users/${userId}/sessions`;
+        const client = this.#client;
+        return {
+            get:    (id = null, { courseId } = {}) => id ? client.get(`${base}/${id}`) : client.get(courseId ? `${base}?course_id=${courseId}` : base),
+            create: (data)      => client.put(base, data),
+            edit:   (id, data)  => client.patch(`${base}/${id}`, data),
+            delete: (id)        => client.del(`${base}/${id}`),
+        };
+    }
+
     surveys(userId)        { return this.#nested(userId, 'surveys'); }
     cart(userId)           { return this.#nested(userId, 'cart'); }