@teamphnx/sduiapi 0.1.4

package/README.md

@@ -0,0 +1,248 @@
+# SduiAPI
+
+TypeScript SDUI API client with WebUntis login support.
+
+DISCLAIMER: An independent, open-source project – not connected to or supported by WebUntis, Untis GmbH or Sdui GmbH.
+
+## Install
+
+```bash
+npm install sduiapi
+```
+
+## Quick Start
+
+```ts
+import { SduiClient } from 'sduiapi';
+
+const client = await SduiClient.authenticateWithWebUntis({
+    schoolSlink: 'example-school',
+    username: process.env.SDUI_USERNAME ?? '',
+    password: process.env.SDUI_PASSWORD ?? '',
+});
+
+const me = await client.getCurrentUser();
+console.log(me);
+```
+
+## Public API
+
+### `SduiClient.authenticateWithWebUntis(credentials, options?)`
+
+Creates an authenticated client by running the full SDUI <-> WebUntis bridge flow.
+
+### `SduiClient.fromAccessToken(accessToken)`
+
+Creates a client when you already have a bearer token.
+
+### `client.request(config)`
+
+Sends any request to the SDUI API using the authenticated HTTP instance.
+
+### `client.getCurrentUser()`
+
+Convenience helper for `GET /v1/users/self`.
+
+### `client.getUserNews(userId, options?)`
+
+Convenience helper for `GET /v1/users/:userId/feed/news`.
+
+```ts
+const news = await client.getUserNews('user-id-placeholder', {
+    page: 2,
+    search: 'announcement',
+});
+```
+
+Options:
+
+- `page` (default: `1`)
+- `search` (default: `''`)
+
+### `client.getUserChats(userId, options?)`
+
+Convenience helper for `GET /v1/users/:userId/channels/chats`.
+
+```ts
+const chats = await client.getUserChats('user-id-placeholder', {
+    page: 2,
+    search: '',
+    limit: 10,
+});
+```
+
+Options:
+
+- `page` (default: `1`)
+- `search` (default: `''`)
+- `limit` (default: `10`)
+
+### `client.getChatMessages(chatId, options?)`
+
+Convenience helper for `GET /v1/channels/chats/:chatId/messages`.
+
+```ts
+const messages = await client.getChatMessages('chat-id-placeholder', {
+    page: 1,
+});
+```
+
+Options:
+
+- `page` (default: `1`)
+
+### `client.getMessageReaders(chatId, messageUuid, options?)`
+
+Convenience helper for `GET /v1/channels/chats/:chatId/messages/:messageUuid/readers`.
+
+```ts
+const readers = await client.getMessageReaders(
+    'readers-chat-id-placeholder',
+    'readers-message-uuid-placeholder',
+    {
+        page: 1,
+        search: '',
+    },
+);
+```
+
+Options:
+
+- `page` (default: `1`)
+- `search` (default: `''`)
+
+### `client.markChatAsRead(chatId, payload?)`
+
+Convenience helper for `POST /v1/channels/chats/:chatId/read`.
+
+```ts
+const result = await client.markChatAsRead('read-chat-id-placeholder', {});
+```
+
+`payload` defaults to `{}` and is forwarded as JSON body.
+
+### `client.sendChatMessage(chatId, payload)`
+
+Convenience helper for `POST /v1/channels/chats/:chatId/messages`.
+
+```ts
+const sent = await client.sendChatMessage('message-chat-id-placeholder', {
+    content: '.',
+});
+```
+
+`payload.content` is required.
+The payload is sent as `multipart/form-data`, and extra payload keys are forwarded as additional form fields.
+
+### `client.replyToChatMessage(chatId, replyUuid, payload)`
+
+Convenience helper for replying via `POST /v1/channels/chats/:chatId/messages` with `reply_uuid`.
+
+```ts
+const sentReply = await client.replyToChatMessage(
+    'message-chat-id-placeholder',
+    'message-uuid-placeholder',
+    {
+        content: 'Hallo',
+    },
+);
+```
+
+### `client.deleteChatMessage(chatId, messageUuid)`
+
+Convenience helper for `DELETE /v1/channels/chats/:chatId/messages/:messageUuid`.
+
+```ts
+const result = await client.deleteChatMessage(
+    'message-chat-id-placeholder',
+    'message-uuid-placeholder',
+);
+```
+
+### `client.getChannelUsers(channelId)`
+
+Convenience helper for `GET /v1/channels/:channelId/users`.
+
+```ts
+const users = await client.getChannelUsers('channel-id-placeholder');
+```
+
+### `authenticateWithWebUntis(credentials, options?)`
+
+Lower-level function that returns:
+
+```ts
+{
+    accessToken: string;
+    http: AxiosInstance;
+}
+```
+
+## Error Handling
+
+Authentication failures throw `SduiAuthError` with an optional `context` object for debugging.
+
+```ts
+import { SduiAuthError, SduiClient } from 'sduiapi';
+
+try {
+    await SduiClient.authenticateWithWebUntis({
+        schoolSlink: 'example-school',
+        username: '...',
+        password: '...',
+    });
+} catch (error) {
+    if (error instanceof SduiAuthError) {
+        console.error(error.message, error.context);
+    }
+}
+```
+
+## Logging
+
+Pass `logger` in options to get structured auth progress events.
+
+```ts
+import { SduiClient } from 'sduiapi';
+
+await SduiClient.authenticateWithWebUntis(
+    {
+        schoolSlink: 'example-school',
+        username: '...',
+        password: '...',
+    },
+    {
+        logger: (event) => {
+            console.log(
+                `[${event.step}] ${event.message}`,
+                event.details ?? {},
+            );
+        },
+    },
+);
+```
+
+## Testing
+
+```bash
+npm test
+```
+
+The tests use mocked HTTP responses, so they do not call SDUI or WebUntis servers.
+
+### Live SDUI integration test (optional)
+
+Create a local .env file (you can copy .env.example):
+
+SDUI_LIVE_TEST=true
+SDUI_SCHOOL_SLINK=example-school
+SDUI_USERNAME=your_webuntis_username
+SDUI_PASSWORD=your_webuntis_password
+
+Run the real integration test:
+
+```bash
+npm run test:live
+```
+
+If SDUI_LIVE_TEST is false, or credentials are missing, the live authentication test is skipped.

package/dist/auth/webUntisAuth.d.ts

@@ -0,0 +1,3 @@
+import type { AuthenticateWithWebUntisOptions, SduiAuthResult, WebUntisCredentials } from '../types.js';
+export declare function authenticateWithWebUntis(credentials: WebUntisCredentials, options?: AuthenticateWithWebUntisOptions): Promise<SduiAuthResult>;
+//# sourceMappingURL=webUntisAuth.d.ts.map

package/dist/auth/webUntisAuth.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"webUntisAuth.d.ts","sourceRoot":"","sources":["../../src/auth/webUntisAuth.ts"],"names":[],"mappings":"AAWA,OAAO,KAAK,EACR,+BAA+B,EAC/B,cAAc,EACd,mBAAmB,EACtB,MAAM,aAAa,CAAC;AAkHrB,wBAAsB,wBAAwB,CAC1C,WAAW,EAAE,mBAAmB,EAChC,OAAO,GAAE,+BAAoC,GAC9C,OAAO,CAAC,cAAc,CAAC,CAmPzB"}

package/dist/auth/webUntisAuth.js

@@ -0,0 +1,202 @@
+import axios, {} from 'axios';
+import { wrapper } from 'axios-cookiejar-support';
+import { CookieJar } from 'tough-cookie';
+import { DEFAULT_REDIRECT_HOP_LIMIT, DEFAULT_REQUEST_HEADERS, DEFAULT_USER_AGENT, SDUI_API_BASE_URL, SDUI_IDP_RETURN_URL, } from '../constants.js';
+import { SduiAuthError } from '../errors.js';
+import { emitLog } from '../utils/logging.js';
+import { extractCsrfToken, extractMetaRefreshUrl, maskSecret, } from '../utils/parsers.js';
+import { buildSduiAuthorizeUrl, resolveRedirectUrl } from '../utils/url.js';
+function createBrowserLikeHttpClient(userAgent) {
+    const cookieJar = new CookieJar();
+    return wrapper(axios.create({
+        maxRedirects: 10,
+        validateStatus: () => true,
+        jar: cookieJar,
+        withCredentials: true,
+        headers: {
+            ...DEFAULT_REQUEST_HEADERS,
+            'User-Agent': userAgent,
+        },
+    }));
+}
+function getFinalResponseUrl(response) {
+    const req = response.request;
+    return req?.res?.responseUrl ?? null;
+}
+function readLocationHeader(response) {
+    const location = response.headers.location;
+    if (typeof location === 'string') {
+        return location;
+    }
+    if (Array.isArray(location) && typeof location[0] === 'string') {
+        return location[0];
+    }
+    return null;
+}
+function isRedirectStatus(statusCode) {
+    return [301, 302, 303, 307, 308].includes(statusCode);
+}
+async function followUntilSduiCallback(http, startUrl, hopLimit, logger) {
+    let nextUrl = startUrl;
+    for (let hop = 1; hop <= hopLimit; hop += 1) {
+        const response = await http.get(nextUrl, {
+            maxRedirects: 0,
+            responseType: 'text',
+            validateStatus: () => true,
+        });
+        const location = readLocationHeader(response);
+        emitLog(logger, 'callback.redirect', 'Following redirect during callback resolution.', {
+            hop,
+            statusCode: response.status,
+            hasLocation: Boolean(location),
+        });
+        if (!location || !isRedirectStatus(response.status)) {
+            return null;
+        }
+        const resolvedUrl = resolveRedirectUrl(nextUrl, location);
+        if (resolvedUrl.startsWith('https://sdui.app/')) {
+            return resolvedUrl;
+        }
+        nextUrl = resolvedUrl;
+    }
+    return null;
+}
+export async function authenticateWithWebUntis(credentials, options = {}) {
+    const schoolSlink = credentials.schoolSlink.trim();
+    const username = credentials.username.trim();
+    const password = credentials.password;
+    if (!schoolSlink || !username || !password) {
+        throw new SduiAuthError('schoolSlink, username and password are required.');
+    }
+    const redirectHopLimit = options.redirectHopLimit ?? DEFAULT_REDIRECT_HOP_LIMIT;
+    if (redirectHopLimit < 1) {
+        throw new SduiAuthError('redirectHopLimit must be at least 1.');
+    }
+    const userAgent = options.userAgent ?? DEFAULT_USER_AGENT;
+    const http = createBrowserLikeHttpClient(userAgent);
+    emitLog(options.logger, 'school.lookup', 'Looking up school configuration.', { schoolSlink });
+    const schoolResponse = await http.get(`${SDUI_API_BASE_URL}/v1/find-schools`, {
+        params: { slink: schoolSlink },
+    });
+    const idpUri = schoolResponse.data?.data?.meta?.external_identity_providers?.[0]
+        ?.uri ?? null;
+    if (!idpUri) {
+        throw new SduiAuthError('Unable to resolve identity provider URL for school.', {
+            schoolSlink,
+            statusCode: schoolResponse.status,
+        });
+    }
+    const authorizeUrl = buildSduiAuthorizeUrl(idpUri, schoolSlink);
+    emitLog(options.logger, 'idp.bridge', 'Triggering SDUI SSO bridge.');
+    const idpResponse = await http.get(authorizeUrl, {
+        responseType: 'text',
+    });
+    const webUntisInitUrl = extractMetaRefreshUrl(idpResponse.data);
+    if (!webUntisInitUrl) {
+        throw new SduiAuthError('Failed to read WebUntis URL from IDP response.');
+    }
+    emitLog(options.logger, 'idp.meta-refresh', 'Resolved meta refresh target.', {
+        webUntisInitUrl,
+    });
+    const loginPageResponse = await http.get(webUntisInitUrl, {
+        responseType: 'text',
+    });
+    const csrfToken = extractCsrfToken(loginPageResponse.data);
+    if (!csrfToken) {
+        throw new SduiAuthError('Could not extract csrfToken from WebUntis page.');
+    }
+    emitLog(options.logger, 'webuntis.csrf', 'Extracted WebUntis CSRF token.', {
+        csrfToken: maskSecret(csrfToken),
+    });
+    const loginPageUrl = getFinalResponseUrl(loginPageResponse) ?? webUntisInitUrl;
+    const parsedLoginPageUrl = new URL(loginPageUrl);
+    const webUntisBaseUrl = `${parsedLoginPageUrl.protocol}//${parsedLoginPageUrl.host}`;
+    const schoolFromLoginUrl = parsedLoginPageUrl.searchParams.get('school') ?? schoolSlink;
+    const loginFormPayload = new URLSearchParams({
+        school: schoolFromLoginUrl,
+        j_username: username,
+        j_password: password,
+    });
+    emitLog(options.logger, 'webuntis.login', 'Submitting WebUntis credentials.', {
+        webUntisBaseUrl,
+        username,
+    });
+    const loginResponse = await http.post(`${webUntisBaseUrl}/WebUntis/j_spring_security_check`, loginFormPayload.toString(), {
+        headers: {
+            'Content-Type': 'application/x-www-form-urlencoded',
+            'X-Requested-With': 'XMLHttpRequest',
+        },
+        maxRedirects: 0,
+        validateStatus: () => true,
+    });
+    emitLog(options.logger, 'webuntis.login.done', 'WebUntis login request finished.', {
+        statusCode: loginResponse.status,
+    });
+    const sduiCallbackUrl = await followUntilSduiCallback(http, webUntisInitUrl, redirectHopLimit, options.logger);
+    if (!sduiCallbackUrl) {
+        throw new SduiAuthError('WebUntis did not redirect to SDUI callback URL. Credentials may be invalid or flow changed.');
+    }
+    const callbackUrl = new URL(sduiCallbackUrl);
+    const code1 = callbackUrl.searchParams.get('code');
+    const state1 = callbackUrl.searchParams.get('state');
+    if (!code1 || !state1) {
+        throw new SduiAuthError('Missing code/state in SDUI callback URL.', {
+            callbackUrl: sduiCallbackUrl,
+        });
+    }
+    emitLog(options.logger, 'idp.exchange.1', 'Exchanging first SDUI bridge code.', {
+        code: maskSecret(code1),
+    });
+    const idpExchangeResponse = await http.get(SDUI_IDP_RETURN_URL, {
+        params: {
+            code: code1,
+            state: state1,
+        },
+        maxRedirects: 0,
+        validateStatus: () => true,
+    });
+    const ssoVerifyLocation = readLocationHeader(idpExchangeResponse);
+    if (!isRedirectStatus(idpExchangeResponse.status) || !ssoVerifyLocation) {
+        throw new SduiAuthError('Failed to exchange code at SDUI identity bridge.', {
+            statusCode: idpExchangeResponse.status,
+        });
+    }
+    const ssoVerifyUrl = resolveRedirectUrl(SDUI_IDP_RETURN_URL, ssoVerifyLocation);
+    const code2 = new URL(ssoVerifyUrl).searchParams.get('code');
+    if (!code2) {
+        throw new SduiAuthError('Missing code in SSO verify redirect URL.', {
+            ssoVerifyUrl,
+        });
+    }
+    emitLog(options.logger, 'idp.exchange.2', 'Exchanging second code for API token.', {
+        code: maskSecret(code2),
+    });
+    const tokenResponse = await http.post(`${SDUI_API_BASE_URL}/v1/auth/login-idm`, {
+        code: code2,
+        slink: schoolSlink,
+    });
+    const accessToken = tokenResponse.data?.data?.access_token ??
+        tokenResponse.data?.access_token;
+    if (!accessToken) {
+        throw new SduiAuthError('Token exchange succeeded but no access token was returned.', {
+            statusCode: tokenResponse.status,
+            responseBody: tokenResponse.data,
+        });
+    }
+    emitLog(options.logger, 'auth.success', 'Authentication completed.', {
+        accessToken: maskSecret(accessToken),
+    });
+    const authenticatedHttp = axios.create({
+        baseURL: SDUI_API_BASE_URL,
+        headers: {
+            Accept: 'application/json',
+            Authorization: `Bearer ${accessToken}`,
+            'User-Agent': userAgent,
+        },
+    });
+    return {
+        accessToken,
+        http: authenticatedHttp,
+    };
+}
+//# sourceMappingURL=webUntisAuth.js.map

package/dist/auth/webUntisAuth.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"webUntisAuth.js","sourceRoot":"","sources":["../../src/auth/webUntisAuth.ts"],"names":[],"mappings":"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"}

package/dist/client.d.ts

@@ -0,0 +1,22 @@
+import { type AxiosInstance, type AxiosRequestConfig } from 'axios';
+import type { AuthenticateWithWebUntisOptions, GetChatMessagesOptions, GetMessageReadersOptions, GetUserChatsOptions, GetUserNewsOptions, MarkChatAsReadPayload, SendChatMessagePayload, WebUntisCredentials } from './types.js';
+export declare class SduiClient {
+    readonly accessToken: string;
+    private readonly http;
+    private constructor();
+    static authenticateWithWebUntis(credentials: WebUntisCredentials, options?: AuthenticateWithWebUntisOptions): Promise<SduiClient>;
+    static fromAccessToken(accessToken: string, userAgent?: string): SduiClient;
+    request<T>(config: AxiosRequestConfig): Promise<T>;
+    getCurrentUser<T = unknown>(): Promise<T>;
+    getUserNews<T = unknown>(userId: string | number, options?: GetUserNewsOptions): Promise<T>;
+    getUserChats<T = unknown>(userId: string | number, options?: GetUserChatsOptions): Promise<T>;
+    getChatMessages<T = unknown>(chatId: string | number, options?: GetChatMessagesOptions): Promise<T>;
+    getMessageReaders<T = unknown>(chatId: string | number, messageUuid: string | number, options?: GetMessageReadersOptions): Promise<T>;
+    markChatAsRead<T = unknown>(chatId: string | number, payload?: MarkChatAsReadPayload): Promise<T>;
+    sendChatMessage<T = unknown>(chatId: string | number, payload: SendChatMessagePayload): Promise<T>;
+    replyToChatMessage<T = unknown>(chatId: string | number, replyUuid: string | number, payload: SendChatMessagePayload): Promise<T>;
+    deleteChatMessage<T = unknown>(chatId: string | number, messageUuid: string | number): Promise<T>;
+    getChannelUsers<T = unknown>(channelId: string | number): Promise<T>;
+    getHttpClient(): AxiosInstance;
+}
+//# sourceMappingURL=client.d.ts.map

package/dist/client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../src/client.ts"],"names":[],"mappings":"AAAA,OAAc,EAAE,KAAK,aAAa,EAAE,KAAK,kBAAkB,EAAE,MAAM,OAAO,CAAC;AAG3E,OAAO,KAAK,EACR,+BAA+B,EAC/B,sBAAsB,EACtB,wBAAwB,EACxB,mBAAmB,EACnB,kBAAkB,EAClB,qBAAqB,EACrB,sBAAsB,EACtB,mBAAmB,EACtB,MAAM,YAAY,CAAC;AAEpB,qBAAa,UAAU;IACnB,SAAgB,WAAW,EAAE,MAAM,CAAC;IACpC,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAgB;IAErC,OAAO;WAKa,wBAAwB,CACxC,WAAW,EAAE,mBAAmB,EAChC,OAAO,GAAE,+BAAoC,GAC9C,OAAO,CAAC,UAAU,CAAC;WAQR,eAAe,CACzB,WAAW,EAAE,MAAM,EACnB,SAAS,GAAE,MAA2B,GACvC,UAAU;IAaA,OAAO,CAAC,CAAC,EAAE,MAAM,EAAE,kBAAkB,GAAG,OAAO,CAAC,CAAC,CAAC;IAKlD,cAAc,CAAC,CAAC,GAAG,OAAO,KAAK,OAAO,CAAC,CAAC,CAAC;IAOzC,WAAW,CAAC,CAAC,GAAG,OAAO,EAChC,MAAM,EAAE,MAAM,GAAG,MAAM,EACvB,OAAO,GAAE,kBAAuB,GACjC,OAAO,CAAC,CAAC,CAAC;IAuBA,YAAY,CAAC,CAAC,GAAG,OAAO,EACjC,MAAM,EAAE,MAAM,GAAG,MAAM,EACvB,OAAO,GAAE,mBAAwB,GAClC,OAAO,CAAC,CAAC,CAAC;IA6BA,eAAe,CAAC,CAAC,GAAG,OAAO,EACpC,MAAM,EAAE,MAAM,GAAG,MAAM,EACvB,OAAO,GAAE,sBAA2B,GACrC,OAAO,CAAC,CAAC,CAAC;IAoBA,iBAAiB,CAAC,CAAC,GAAG,OAAO,EACtC,MAAM,EAAE,MAAM,GAAG,MAAM,EACvB,WAAW,EAAE,MAAM,GAAG,MAAM,EAC5B,OAAO,GAAE,wBAA6B,GACvC,OAAO,CAAC,CAAC,CAAC;IA4BA,cAAc,CAAC,CAAC,GAAG,OAAO,EACnC,MAAM,EAAE,MAAM,GAAG,MAAM,EACvB,OAAO,GAAE,qBAA0B,GACpC,OAAO,CAAC,CAAC,CAAC;IAaA,eAAe,CAAC,CAAC,GAAG,OAAO,EACpC,MAAM,EAAE,MAAM,GAAG,MAAM,EACvB,OAAO,EAAE,sBAAsB,GAChC,OAAO,CAAC,CAAC,CAAC;IA8BA,kBAAkB,CAAC,CAAC,GAAG,OAAO,EACvC,MAAM,EAAE,MAAM,GAAG,MAAM,EACvB,SAAS,EAAE,MAAM,GAAG,MAAM,EAC1B,OAAO,EAAE,sBAAsB,GAChC,OAAO,CAAC,CAAC,CAAC;IAYA,iBAAiB,CAAC,CAAC,GAAG,OAAO,EACtC,MAAM,EAAE,MAAM,GAAG,MAAM,EACvB,WAAW,EAAE,MAAM,GAAG,MAAM,GAC7B,OAAO,CAAC,CAAC,CAAC;IAiBA,eAAe,CAAC,CAAC,GAAG,OAAO,EACpC,SAAS,EAAE,MAAM,GAAG,MAAM,GAC3B,OAAO,CAAC,CAAC,CAAC;IAYN,aAAa,IAAI,aAAa;CAGxC"}