@insignia-education/api-sdk-js 0.9.26 → 0.9.29

package/AGENTS.md

@@ -67,7 +67,16 @@ The SDK is language-neutral — it must never contain human-readable strings.
 - Error objects thrown by the SDK must expose a machine-readable `status` (HTTP code) and `data` (raw API body). The consuming app handles translation.
 - Do not add locale/language logic to the SDK — that belongs to the frontend.
 
+## API ↔ SDK sync rule
+
+**This SDK must stay in sync with [`insignia-education/api`](../api) at all times.** Any endpoint added, renamed, or removed in the API must be reflected here in the same task/commit.
+
+- New endpoint in `api` → new method in the correct `src/api/v1/*.js` class
+- Removed endpoint → remove or deprecate the corresponding SDK method
+- Never leave the SDK behind the API; the `front` repo relies solely on this SDK
+
 ## 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

package/package.json

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

package/src/api/v1/Files.js

@@ -5,7 +5,21 @@ export default class Files {
         this.#client = client;
     }
 
-    get(id = null)              { return id ? this.#client.get(`/files/${id}`) : this.#client.get('/files'); }
+    /** List files in a directory. params: { organization_id, directory, per_page } */
+    list(params = {})           { return this.#client.get('/files', params); }
+
+    /** Get a single file record by ID. */
+    get(id)                     { return this.#client.get(`/files/${id}`); }
+
+    /** Upload a file (FormData). Supports: file, folder, organization_id, filename, generate_webp, … */
     upload(formData)            { return this.#client.upload('/files', formData); }
-    delete(id)                  { return this.#client.del(`/files/${id}`); }
+
+    /** Create a logical folder. body: { organization_id, path } */
+    createFolder(body)          { return this.#client.upload('/files/folder', body); }
+
+    /** Update file description. body: { description } */
+    update(id, body)            { return this.#client.patch(`/files/${id}`, body); }
+
+    /** Soft-delete a file. Pass s3=true to also remove from S3. */
+    delete(id, s3 = false)      { return this.#client.del(`/files/${id}${s3 ? '?s3=1' : ''}`); }
 }

package/src/api/v1/Users.js

@@ -5,8 +5,10 @@ export default class Users {
         this.#client = client;
     }
 
-    get(id = null)      { return id ? this.#client.get(`/users/${id}`) : this.#client.get('/users'); }
-    cashReceivers()     { return this.#client.get('/users/cash-receivers'); }
+    get(id = null)            { return id ? this.#client.get(`/users/${id}`) : this.#client.get('/users'); }
+    getByUsername(username)   { return this.#client.get(`/users/username/${username}`); }
+    findByUsername(username)  { return this.#client.get(`/users/find/${username}`); }
+    cashReceivers()           { return this.#client.get('/users/cash-receivers'); }
     edit(id, data)  { return this.#client.patch(`/users/${id}`, data); }
 
     #nested(userId, path) {
@@ -61,6 +63,17 @@ export default class Users {
 
     statistics(userId)     { return { get: () => this.#client.get(`/users/${userId}/statistics`) }; }
 
+    experiences(userId) {
+        const base = `/users/${userId}/experiences`;
+        const client = this.#client;
+        return {
+            get:    (id = null) => id ? client.get(`${base}/${id}`) : client.get(base),
+            create: (data)      => client.put(base, data),
+            edit:   (id, data)  => client.patch(`${base}/${id}`, data),
+            delete: (id)        => client.del(`${base}/${id}`),
+        };
+    }
+
     organizations(userId) {
         const base = `/users/${userId}/organizations`;
         const client = this.#client;