@insignia-education/api-sdk-js 0.15.71 → 0.15.74

package/tests/client.test.js

@@ -1,265 +0,0 @@
-import InsigniaClient from '../src/Client.js';
-import Users from '../src/api/v1/Users.js';
-
-const BASE = 'http://localhost:8000';
-
-function mockFetch(json = {}) {
-    return jest.fn().mockResolvedValue({ ok: true, status: 200, json: () => Promise.resolve(json) });
-}
-
-beforeEach(() => {
-    delete process.env.INSIGNIA_EDUCATION_API_BASE_URL;
-});
-
-afterEach(() => {
-    delete global.fetch;
-    delete process.env.INSIGNIA_EDUCATION_API_BASE_URL;
-});
-
-// ─── baseUrl resolution ───────────────────────────────────────────────────────
-
-describe('baseUrl resolution', () => {
-    test('uses explicit baseUrl when provided', async () => {
-        global.fetch = mockFetch();
-        const client = new InsigniaClient('https://custom.example.com');
-        await client.get('/test');
-        expect(global.fetch).toHaveBeenCalledWith(
-            'https://custom.example.com/test',
-            expect.any(Object)
-        );
-    });
-
-    test('strips trailing slash from explicit baseUrl', async () => {
-        global.fetch = mockFetch();
-        const client = new InsigniaClient('https://custom.example.com/');
-        await client.get('/test');
-        expect(global.fetch).toHaveBeenCalledWith(
-            'https://custom.example.com/test',
-            expect.any(Object)
-        );
-    });
-
-    test('uses INSIGNIA_EDUCATION_API_BASE_URL env var when baseUrl is null', async () => {
-        process.env.INSIGNIA_EDUCATION_API_BASE_URL = 'https://env.example.com';
-        global.fetch = mockFetch();
-        const client = new InsigniaClient(null);
-        await client.get('/test');
-        expect(global.fetch).toHaveBeenCalledWith(
-            'https://env.example.com/test',
-            expect.any(Object)
-        );
-    });
-
-    test('baseUrl getter exposes the resolved base URL', () => {
-        const client = new InsigniaClient('https://custom.example.com/');
-        expect(client.baseUrl).toBe('https://custom.example.com');
-    });
-
-    test('falls back to https://insigniaeducation.com when baseUrl is null and env var is not set', async () => {
-        global.fetch = mockFetch();
-        const client = new InsigniaClient(null);
-        await client.get('/test');
-        expect(global.fetch).toHaveBeenCalledWith(
-            'https://insigniaeducation.com/test',
-            expect.any(Object)
-        );
-    });
-
-    test('falls back to default when constructed with no arguments', async () => {
-        global.fetch = mockFetch();
-        const client = new InsigniaClient();
-        await client.get('/test');
-        expect(global.fetch).toHaveBeenCalledWith(
-            'https://insigniaeducation.com/test',
-            expect.any(Object)
-        );
-    });
-
-    test('explicit baseUrl takes precedence over env var', async () => {
-        process.env.INSIGNIA_EDUCATION_API_BASE_URL = 'https://env.example.com';
-        global.fetch = mockFetch();
-        const client = new InsigniaClient('https://explicit.example.com');
-        await client.get('/test');
-        expect(global.fetch).toHaveBeenCalledWith(
-            'https://explicit.example.com/test',
-            expect.any(Object)
-        );
-    });
-
-    test('falls back to default when process is undefined', async () => {
-        const saved = global.process;
-        global.process = undefined;
-        global.fetch = mockFetch();
-        const client = new InsigniaClient(null);
-        await client.get('/test');
-        expect(global.fetch).toHaveBeenCalledWith(
-            'https://insigniaeducation.com/test',
-            expect.any(Object)
-        );
-        global.process = saved;
-    });
-});
-
-// ─── HTTP methods ─────────────────────────────────────────────────────────────
-
-describe('HTTP methods', () => {
-    let client;
-
-    beforeEach(() => {
-        global.fetch = mockFetch();
-        client = new InsigniaClient(BASE);
-    });
-
-    test('get() sends GET with no body', async () => {
-        await client.get('/path');
-        const [url, options] = global.fetch.mock.calls[0];
-        expect(url).toBe(`${BASE}/path`);
-        expect(options.method).toBe('GET');
-        expect(options.body).toBeUndefined();
-    });
-
-    test('post() sends POST with body', async () => {
-        await client.post('/path', { key: 'val' });
-        const [url, options] = global.fetch.mock.calls[0];
-        expect(url).toBe(`${BASE}/path`);
-        expect(options.method).toBe('POST');
-        expect(options.body).toBe(JSON.stringify({ key: 'val' }));
-    });
-
-    test('post() sends POST with no body when not provided', async () => {
-        await client.post('/path');
-        const [, options] = global.fetch.mock.calls[0];
-        expect(options.method).toBe('POST');
-        expect(options.body).toBeUndefined();
-    });
-
-    test('put() sends PUT with body', async () => {
-        await client.put('/path', { key: 'val' });
-        const [url, options] = global.fetch.mock.calls[0];
-        expect(url).toBe(`${BASE}/path`);
-        expect(options.method).toBe('PUT');
-        expect(options.body).toBe(JSON.stringify({ key: 'val' }));
-    });
-
-    test('put() sends PUT with no body when not provided', async () => {
-        await client.put('/path');
-        const [, options] = global.fetch.mock.calls[0];
-        expect(options.method).toBe('PUT');
-        expect(options.body).toBeUndefined();
-    });
-
-    test('patch() sends PATCH with body', async () => {
-        await client.patch('/path', { key: 'val' });
-        const [url, options] = global.fetch.mock.calls[0];
-        expect(url).toBe(`${BASE}/path`);
-        expect(options.method).toBe('PATCH');
-        expect(options.body).toBe(JSON.stringify({ key: 'val' }));
-    });
-
-    test('patch() sends PATCH with no body when not provided', async () => {
-        await client.patch('/path');
-        const [, options] = global.fetch.mock.calls[0];
-        expect(options.method).toBe('PATCH');
-        expect(options.body).toBeUndefined();
-    });
-
-    test('del() sends DELETE with no body', async () => {
-        await client.del('/path');
-        const [url, options] = global.fetch.mock.calls[0];
-        expect(url).toBe(`${BASE}/path`);
-        expect(options.method).toBe('DELETE');
-        expect(options.body).toBeUndefined();
-    });
-
-    test('JSON headers are always sent', async () => {
-        await client.get('/path');
-        const [, options] = global.fetch.mock.calls[0];
-        expect(options.headers.Accept).toBe('application/json');
-        expect(options.headers['Content-Type']).toBe('application/json');
-    });
-
-    test('credentials is always include', async () => {
-        await client.get('/path');
-        const [, options] = global.fetch.mock.calls[0];
-        expect(options.credentials).toBe('include');
-    });
-
-    test('stores response cookies and sends them on later requests in Node', async () => {
-        global.fetch = jest.fn()
-            .mockResolvedValueOnce({
-                ok: true,
-                status: 200,
-                headers: {
-                    getSetCookie: () => ['token=abc123; Path=/; HttpOnly; Secure; SameSite=Lax'],
-                },
-                json: () => Promise.resolve({ success: 'ok' }),
-            })
-            .mockResolvedValueOnce({
-                ok: true,
-                status: 200,
-                json: () => Promise.resolve({ id: 1, title: 'test' }),
-            });
-        client = new InsigniaClient(BASE);
-
-        await client.post('/auth/login', { email: 'admin@example.com', password: 'secret' });
-        await client.get('/accounts');
-
-        const [, options] = global.fetch.mock.calls[1];
-        expect(options.headers.Cookie).toBe('token=abc123');
-    });
-
-    test('returns parsed JSON from response', async () => {
-        global.fetch = jest.fn().mockResolvedValue({
-            ok: true,
-            status: 200,
-            json: () => Promise.resolve({ id: 1, name: 'test' }),
-        });
-        client = new InsigniaClient(BASE);
-        const result = await client.get('/path');
-        expect(result).toEqual({ id: 1, name: 'test' });
-    });
-
-    test('returns null for empty response text', async () => {
-        global.fetch = jest.fn().mockResolvedValue({
-            ok: true,
-            status: 200,
-            text: () => Promise.resolve(''),
-        });
-        client = new InsigniaClient(BASE);
-        const result = await client.get('/path');
-        expect(result).toBeNull();
-    });
-
-    test('returns null for no-content responses', async () => {
-        global.fetch = jest.fn().mockResolvedValue({
-            ok: true,
-            status: 204,
-            json: jest.fn(),
-        });
-        client = new InsigniaClient(BASE);
-        const result = await client.del('/path');
-        expect(result).toBeNull();
-    });
-
-    test('returns null when json parsing fails because the response is empty', async () => {
-        global.fetch = jest.fn().mockResolvedValue({
-            ok: true,
-            status: 200,
-            json: () => Promise.reject(new SyntaxError('Unexpected end of JSON input')),
-        });
-        client = new InsigniaClient(BASE);
-        const result = await client.get('/path');
-        expect(result).toBeNull();
-    });
-});
-
-// ─── payments(userId).invoiceUrl ──────────────────────────────────────────────
-// A direct link, not a fetch — no HTTP call to mock/assert on, just the URL shape.
-
-describe('Users.payments(userId).invoiceUrl', () => {
-    test('builds a direct link to the invoice endpoint', () => {
-        const client = new InsigniaClient(BASE);
-        const users = new Users(client);
-        expect(users.payments(42).invoiceUrl(7)).toBe(`${BASE}/users/42/payments/7/invoice`);
-    });
-});

package/tests/helpers.js

@@ -1,21 +0,0 @@
-import InsigniaApiV1 from '../src/api/v1/index.js';
-
-export const api = new InsigniaApiV1(process.env.INSIGNIA_EDUCATION_API_BASE_URL);
-
-// captcha_token is required by LoginRequest; relies on the local API's TURNSTILE_SECRET_KEY
-// being set to Cloudflare's documented "always passes" testing secret
-// (1x0000000000000000000000000000000AA), which accepts any token value.
-export const loginCustomer = () => api.auth.login({
-    email: process.env.TEST_EMAIL,
-    password: process.env.TEST_PASSWORD,
-    captcha_token: 'test',
-});
-
-export const loginAdmin = () => api.auth.login({
-    email: process.env.TEST_EMAIL_ADMIN,
-    password: process.env.TEST_PASSWORD_ADMIN,
-    captcha_token: 'test',
-});
-
-
-export const logout = () => api.auth.logout();

package/tests/integration/api/v1/accounts.test.js

@@ -1,31 +0,0 @@
-import { 
-    api, 
-    loginCustomer,
-    loginAdmin
-} from '../../../helpers.js';
-
-describe('api/v1/accounts', () => {
-    // Client#request() throws on non-2xx (err.status, err.data) rather than
-    // resolving — assert against a rejected promise, not a resolved
-    // {success, status}.
-    test('get | unauthenticated', async () => {
-        await expect(api.accounts.get()).rejects.toMatchObject({ status: 401 });
-    });
-    test('get | authenticated but other type', async () => {
-        await loginCustomer();
-        await expect(api.accounts.get()).rejects.toMatchObject({ status: 403 });
-    });
-    test('get | authenticated', async () => {
-        await loginAdmin();
-        await api.accounts.get()
-            .then(response => {
-                response = Object.values(response);
-                expect(response.length > 0).toBe(true);
-                response.forEach(account => {
-                    expect(account["id"]).toBeDefined();
-                    expect(account["cod"]).toBeDefined();
-                    expect(account["title"]).toBeDefined();
-                });
-            });
-    });
-});

package/tests/integration/api/v1/auth/login.test.js

@@ -1,44 +0,0 @@
-import {
-    api,
-    loginAdmin,
-} from '../../../../helpers.js';
-
-describe('api/v1/auth/login', () => {
-    // Client#request() throws on non-2xx (err.status, err.data) rather than
-    // resolving — assert against a rejected promise, not a resolved
-    // {success, status, errors}. Also no logout() before these — a fresh
-    // `api` client (one per test file) starts out unauthenticated, and
-    // logout() itself throws 401 when there's no session to clear.
-    test('POST | failure | no email validation', async () => {
-        const password = process.env.TEST_PASSWORD;
-        await expect(api.auth.login({ password })).rejects.toMatchObject({
-            status: 422,
-            data: { errors: expect.objectContaining({ email: expect.anything() }) },
-        });
-    });
-
-    test('POST | failure | no password validation', async () => {
-        const email = process.env.TEST_EMAIL;
-        await expect(api.auth.login({ email })).rejects.toMatchObject({
-            status: 422,
-            data: { errors: expect.objectContaining({ password: expect.anything() }) },
-        });
-    });
-
-    test('POST | success', async () => {
-        await loginAdmin()
-            .then(response => {
-                expect(response["success"]).toBeDefined();
-                expect(response["success"]).toBe("ok");
-            });
-    });
-
-    test('POST | double login', async () => {
-        await loginAdmin()
-        .then(() => loginAdmin()
-            .then(response => {
-                expect(response["success"]).toBeDefined();
-                expect(response["success"]).toBe("ok");
-            }));
-    });
-});

package/tests/integration/api/v1/changelogs.test.js

@@ -1,21 +0,0 @@
-import { 
-    api, 
-    loginCustomer,
-    loginAdmin
-} from '../../../helpers.js';
-
-describe('api/v1/changelogs', () => {
-    test('get | authenticated', async () => {
-        await loginAdmin();
-        await api.changelogs.get()
-            .then(response => {
-                response = Object.values(response);
-                expect(Array.isArray(response)).toBe(true);
-                response.forEach(changelog => {
-                    expect(changelog["id"]).toBeDefined();
-                    expect(changelog["created_at"]).toBeDefined();
-                    expect(changelog["updated_at"]).toBeDefined();
-                });
-            });
-    });
-});

package/tests/integration/api/v1/contact-forms.test.js

@@ -1,24 +0,0 @@
-import { 
-    api, 
-    loginCustomer,
-    loginAdmin
-} from '../../../helpers.js';
-
-
-describe('api/v1/contact-forms', () => {
-    test('get | authenticated', async () => {
-        await loginAdmin();
-        await api.contactForms.get()
-            .then(response => {
-                response = Object.values(response);
-                expect(Array.isArray(response)).toBe(true);
-                response.forEach(form => {
-                    expect(form["id"]).toBeDefined();
-                    expect(form["name"]).toBeDefined();
-                    expect(form["email"]).toBeDefined();
-                    expect(form["message"]).toBeDefined();
-                    expect(form["created_at"]).toBeDefined();
-                });
-            });
-    });
-});

package/tests/integration/api/v1/conversational-topics.test.js

@@ -1,17 +0,0 @@
-import { api, loginAdmin } from '../../../helpers.js';
-
-describe('api/v1/conversational-topics', () => {
-    test('get', async () => {
-        await loginAdmin();
-        await api.conversationalTopics.get()
-            .then(response => {
-                response = Object.values(response);
-                expect(response.length > 0).toBe(true);
-                response.forEach(topic => {
-                    expect(topic["id"]).toBeDefined();
-                    expect(topic["title"]).toBeDefined();
-                    expect(topic["date"]).toBeDefined();
-                });
-            });
-    });
-});

package/tests/integration/api/v1/countries.test.js

@@ -1,20 +0,0 @@
-
-import InsigniaApiV1 from '../../../../src/api/v1/index.js';
-
-const api = new InsigniaApiV1(process.env.INSIGNIA_EDUCATION_API_BASE_URL);
-
-describe('api/v1/countries', () => {
-    test('get', async () => {
-        await api.countries.get()
-        .then(response => {
-            response = Object.values(response);
-            expect(response.length > 0).toBe(true);
-            response.forEach(country => {
-                expect(country["id"]).toBeDefined();
-                expect(country["cod"]).toBeDefined();
-                expect(country["domain"]).toBeDefined();
-                expect(country["phone_prefix"]).toBeDefined();
-            })
-        });
-    });
-});

package/tests/integration/api/v1/coupons.test.js

@@ -1,19 +0,0 @@
-import { api, loginAdmin } from '../../../helpers.js';
-
-describe('api/v1/coupons', () => {
-    test('get | authenticated', async () => {
-        await loginAdmin();
-        await api.coupons.get()
-            .then(response => {
-                response = Object.values(response);
-                expect(Array.isArray(response)).toBe(true);
-                response.forEach(coupon => {
-                    expect(coupon["id"]).toBeDefined();
-                    expect(coupon["cod"]).toBeDefined();
-                    expect(coupon["enabled"]).toBeDefined();
-                    expect(coupon["created_at"]).toBeDefined();
-                    expect(coupon["updated_at"]).toBeDefined();
-                });
-            });
-    });
-});

package/tests/integration/api/v1/courses/by-cod.test.js

@@ -1,19 +0,0 @@
-import { 
-    api, 
-    loginCustomer,
-    loginAdmin
-} from '../../../../helpers.js';
-
-describe('api/v1/courses/cod/:cod', () => {
-    test('get by cod | returns matching course', async () => {
-        const firstPage = await api.courses.get();
-        const cod = firstPage["data"][0]["cod"];
-        await api.courses.getByCod(cod)
-            .then(response => {
-                expect(response["id"]).toBeDefined();
-                expect(response["cod"]).toBe(cod);
-                expect(response["title"]).toBeDefined();
-                expect(response["enabled"]).toBeDefined();
-            });
-    });
-});

package/tests/integration/api/v1/courses/index.test.js

@@ -1,46 +0,0 @@
-import { 
-    api, 
-    loginCustomer,
-    loginAdmin
-} from '../../../../helpers.js';
-
-describe('api/v1/courses', () => {
-    test('get | returns paginated list', async () => {
-        await api.courses.get()
-            .then(response => {
-                console.log(response);
-                expect(response["data"]).toBeDefined();
-                expect(response["current_page"]).toBeDefined();
-                expect(response["last_page"]).toBeDefined();
-                expect(response["per_page"]).toBeDefined();
-                expect(response["total"]).toBeDefined();
-                expect(Array.isArray(response["data"])).toBe(true);
-                expect(response["data"].length > 0).toBe(true);
-                response["data"].forEach(course => {
-                    expect(course["id"]).toBeDefined();
-                    expect(course["cod"]).toBeDefined();
-                    expect(course["title"]).toBeDefined();
-                    expect(course["enabled"]).toBeDefined();
-                });
-            });
-    });
-
-    test('get | page 2', async () => {
-        await api.courses.get(null, { page: 2 })
-            .then(response => {
-                expect(response["data"]).toBeDefined();
-                expect(response["current_page"]).toBe(2);
-            });
-    });
-
-    test('get by id | returns single course', async () => {
-        const firstPage = await api.courses.get();
-        const id = firstPage["data"][0]["id"];
-        await api.courses.get(id)
-            .then(response => {
-                expect(response["id"]).toBe(id);
-                expect(response["cod"]).toBeDefined();
-                expect(response["title"]).toBeDefined();
-            });
-    });
-});

package/tests/integration/api/v1/currencies/history.test.js

@@ -1,23 +0,0 @@
-import {
-    api,
-    loginCustomer,
-    loginAdmin
-} from '../../../../helpers.js';
-
-describe('api/v1/currencies/{id}/history', () => {
-
-    test('get', async () => {
-        await loginAdmin();
-        await api.currencies.getHistory(1)
-        .then(response => {
-            response = Object.values(response);
-            response.forEach(value => {
-                expect(value["id"]).toBeDefined();
-                expect(value["currency_id"]).toBeDefined();
-                expect(value["value"]).toBeDefined();
-                expect(value["created_at"]).toBeDefined();
-                expect(value["updated_at"]).toBeDefined();
-            })
-        });
-    });
-});

package/tests/integration/api/v1/currencies/index.test.js

@@ -1,24 +0,0 @@
-import { 
-    api, 
-    loginCustomer,
-    loginAdmin
-} from '../../../../helpers.js';
-
-describe('api/v1/currencies', () => {
-    test('get', async () => {
-        await api.currencies.get()
-        .then(response => {
-            expect(response["1"]).toBeDefined();
-            expect(response["1"]["id"]).toBeDefined();
-            expect(response["1"]["country_id"]).toBeDefined();
-            expect(response["1"]["cod"]).toBeDefined();
-            expect(response["1"]["title"]).toBeDefined();
-            expect(response["1"]["enabled"]).toBeDefined();
-            expect(response["1"]["has_double_expression"]).toBeDefined();
-            expect(response["1"]["double_expression_by"]).toBeDefined();
-            expect(response["1"]["created_at"]).toBeDefined();
-            expect(response["1"]["updated_at"]).toBeDefined();
-            expect(response["1"]["deleted_at"]).toBeDefined();
-        });
-    });
-});

package/tests/integration/api/v1/currencies/values.test.js

@@ -1,24 +0,0 @@
-import { 
-    api, 
-    loginCustomer,
-    loginAdmin
-} from '../../../../helpers.js';
-
-describe('api/v1/currencies/values', () => {
-
-    test('get', async () => {
-        await api.currencies.getValues()
-        .then(response => {
-            response = Object.values(response);
-            expect(response.length > 0).toBe(true);
-            response.forEach(value => {
-                expect(value["id"]).toBeDefined();
-                expect(value["currency_id"]).toBeDefined();
-                expect(value["value"]).toBeDefined();
-                expect(value["created_at"]).toBeDefined();
-                expect(value["updated_at"]).toBeDefined();
-            })
-            
-        });
-    });
-});

package/tests/integration/api/v1/files.test.js

@@ -1,42 +0,0 @@
-import { Blob } from 'buffer';
-import { api, loginAdmin } from '../../../helpers.js';
-
-// A real 1x1 transparent PNG (67 bytes) — the upload endpoint sniffs actual
-// file content, not just the claimed Content-Type, so arbitrary text with an
-// 'image/png' MIME hint gets rejected with "Unsupported file type".
-const PNG_1X1 = Buffer.from(
-    'iVBORw0KGgoAAAANSUhEUgAAAAEAAAABCAQAAAC1HAwCAAAAC0lEQVR42mNk+A8AAQUBAScY42YAAAAASUVORK5CYII=',
-    'base64'
-);
-
-describe('api/v1/files', () => {
-    // list() (paginated), not get() — get(id) requires an id and hits
-    // /files/{id}, unlike most other resources' get(id = null).
-    test('list | authenticated', async () => {
-        await loginAdmin();
-        await api.files.list()
-            .then(response => {
-                const files = response["data"];
-                expect(Array.isArray(files)).toBe(true);
-                files.forEach(file => {
-                    expect(file["id"]).toBeDefined();
-                    expect(file["created_at"]).toBeDefined();
-                    expect(file["updated_at"]).toBeDefined();
-                });
-            });
-    });
-
-    test('upload | authenticated', async () => {
-        await loginAdmin();
-        const blob = new Blob([PNG_1X1], { type: 'image/png' });
-        const fd   = new FormData();
-        fd.append('file', blob, 'test.png');
-        fd.append('type', 'uploads');
-        await api.files.upload(fd)
-            .then(response => {
-                expect(response).toBeDefined();
-                expect(response['url']).toBeDefined();
-                expect(response['id']).toBeDefined();
-            });
-    });
-});