@insignia-education/api-sdk-js 0.15.20 → 0.15.22

package/package.json

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

package/src/api/v1/Payments.js

@@ -24,6 +24,23 @@ export default class Payments {
         };
     }
 
+    /**
+     * Employee-only: apply or lift a coupon on an existing payment. A coupon
+     * only discounts the lines it actually covers — preview() reports which
+     * those are (and the resulting discount) without writing anything, and
+     * apply() rejects a coupon that matches none of the payment's items.
+     * Both apply() and remove() return the reloaded payment with its items.
+     */
+    coupon(paymentId) {
+        const base = `/payments/${paymentId}/coupon`;
+        const client = this.#client;
+        return {
+            preview: (cod) => client.get(`${base}/preview`, { cod }),
+            apply:   (cod) => client.post(base, { cod }),
+            remove:  ()    => client.del(base),
+        };
+    }
+
     /**
      * Employee-only: remove/restore any of a payment's line items. Removal is a
      * soft delete — the line stays visible in the admin panel flagged as removed,
@@ -34,6 +51,14 @@ export default class Payments {
         const base = `/payments/${paymentId}`;
         const client = this.#client;
         return {
+            /**
+             * Adds a line. `data` carries only identifiers — every price is
+             * derived server-side from the selected entity, never sent by the
+             * client. By type: courses `{course_id, course_date_id?}`, premiums
+             * `{course_premium_id}`, sessions `{course_id, type_id, quantity}`,
+             * quizzes `{quiz_id, course_id, quantity}`, taxes `{tax_id}`.
+             */
+            create:  (type, data) => client.put(`${base}/${type}`, data),
             delete:  (type, id) => client.del(`${base}/${type}/${id}`),
             restore: (type, id) => client.post(`${base}/${type}/${id}/restore`),
         };