gammait 1.0.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 olillin
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/lib/api.d.ts

@@ -0,0 +1,48 @@
+import oauth2 from 'simple-oauth2';
+import { ClientAuthority, Group, GroupWithPost, Scope, SuperGroup, User, UserId, UserInfo, UserWithGroups } from './types';
+declare abstract class Client {
+    protected abstract fetch<T extends object>(url: string, method: string): Promise<T>;
+}
+interface ApiClientConfig {
+    authorization: string;
+}
+declare class ApiClient extends Client {
+    config: ApiClientConfig;
+    constructor(config: ApiClientConfig);
+    protected fetch<T extends object>(url: string, method?: string): Promise<T>;
+}
+export declare class ClientApi extends ApiClient {
+    getUsers(): Promise<User[]>;
+    getUser(id: UserId): Promise<User>;
+    getGroups(): Promise<Group[]>;
+    getGroupsFor(id: UserId): Promise<GroupWithPost[]>;
+    getSuperGroups(): Promise<SuperGroup[]>;
+    getAuthorities(): Promise<ClientAuthority[]>;
+    getAuthoritiesFor(id: UserId): Promise<ClientAuthority[]>;
+}
+export declare class InfoApi extends ApiClient {
+    getUser(id: UserId): Promise<UserWithGroups>;
+}
+export interface AuthorizationCodeConfig {
+    clientId: string;
+    clientSecret: string;
+    redirectUri: string;
+    scope: Scope[];
+}
+export declare class AuthorizationCode extends Client {
+    config: AuthorizationCodeConfig;
+    oauth2Client: oauth2.AuthorizationCode;
+    accessToken: oauth2.AccessToken | undefined;
+    constructor(config: AuthorizationCodeConfig);
+    /**
+     * Generate a new access token and store it for later
+     * @param code Authorization code
+     * @returns The generated access token
+     */
+    generateToken(code: string): Promise<oauth2.AccessToken>;
+    authorizeUrl(): string;
+    protected fetch<T extends object>(url: string, method?: string): Promise<T>;
+    userInfo(): Promise<UserInfo>;
+}
+export {};
+//# sourceMappingURL=api.d.ts.map

package/lib/api.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"api.d.ts","sourceRoot":"","sources":["../src/api.ts"],"names":[],"mappings":"AAAA,OAAO,MAAM,MAAM,eAAe,CAAA;AAClC,OAAO,EAAE,eAAe,EAAE,KAAK,EAAE,aAAa,EAAE,KAAK,EAAE,UAAU,EAAE,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,cAAc,EAAE,MAAM,SAAS,CAAA;AAG1H,uBAAe,MAAM;IACjB,SAAS,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,SAAS,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,CAAC,CAAC;CACtF;AAED,UAAU,eAAe;IACrB,aAAa,EAAE,MAAM,CAAA;CACxB;AAED,cAAM,SAAU,SAAQ,MAAM;IAC1B,MAAM,EAAE,eAAe,CAAA;gBAEX,MAAM,EAAE,eAAe;IAKnC,SAAS,CAAC,KAAK,CAAC,CAAC,SAAS,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,MAAM,GAAE,MAAc,GAAG,OAAO,CAAC,CAAC,CAAC;CA2BrF;AAED,qBAAa,SAAU,SAAQ,SAAS;IACpC,QAAQ,IAAI,OAAO,CAAC,IAAI,EAAE,CAAC;IAI3B,OAAO,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAIlC,SAAS,IAAI,OAAO,CAAC,KAAK,EAAE,CAAC;IAI7B,YAAY,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,EAAE,CAAC;IAIlD,cAAc,IAAI,OAAO,CAAC,UAAU,EAAE,CAAC;IAIvC,cAAc,IAAI,OAAO,CAAC,eAAe,EAAE,CAAC;IAI5C,iBAAiB,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,eAAe,EAAE,CAAC;CAG5D;AAED,qBAAa,OAAQ,SAAQ,SAAS;IAClC,OAAO,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,CAAC;CAO/C;AAED,MAAM,WAAW,uBAAuB;IACpC,QAAQ,EAAE,MAAM,CAAA;IAChB,YAAY,EAAE,MAAM,CAAA;IACpB,WAAW,EAAE,MAAM,CAAA;IACnB,KAAK,EAAE,KAAK,EAAE,CAAA;CACjB;AAED,qBAAa,iBAAkB,SAAQ,MAAM;IACzC,MAAM,EAAE,uBAAuB,CAAA;IAC/B,YAAY,EAAE,MAAM,CAAC,iBAAiB,CAAA;IACtC,WAAW,EAAE,MAAM,CAAC,WAAW,GAAG,SAAS,CAAA;gBAE/B,MAAM,EAAE,uBAAuB;IAoB3C;;;;OAIG;IACG,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,WAAW,CAAC;IAU9D,YAAY;IAOZ,SAAS,CAAC,KAAK,CAAC,CAAC,SAAS,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,MAAM,GAAE,MAAc,GAAG,OAAO,CAAC,CAAC,CAAC;IAgClF,QAAQ,IAAI,OAAO,CAAC,QAAQ,CAAC;CAGhC"}

package/lib/api.js

@@ -0,0 +1,182 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AuthorizationCode = exports.InfoApi = exports.ClientApi = void 0;
+const simple_oauth2_1 = __importDefault(require("simple-oauth2"));
+const url = __importStar(require("./urls"));
+class Client {
+}
+class ApiClient extends Client {
+    config;
+    constructor(config) {
+        super();
+        this.config = config;
+    }
+    fetch(url, method = 'GET') {
+        return new Promise((resolve, reject) => {
+            fetch(url, {
+                headers: {
+                    Authorization: this.config.authorization,
+                },
+                method: method,
+            })
+                .then(async (res) => {
+                if (!res.ok) {
+                    reject(`Received code ${res.status} during ${method} to ${url}`);
+                    return;
+                }
+                if (!res.headers.has('Content-Type') || res.headers.get('Content-Type') !== 'application/json') {
+                    reject('Response was not JSON');
+                    return;
+                }
+                const data = await res.json();
+                resolve(data);
+            })
+                .catch(reason => {
+                reject(reason);
+            });
+        });
+    }
+}
+class ClientApi extends ApiClient {
+    getUsers() {
+        return this.fetch(url.CLIENT_API_USERS);
+    }
+    getUser(id) {
+        return this.fetch(url.clientApiUser(id));
+    }
+    getGroups() {
+        return this.fetch(url.CLIENT_API_GROUPS);
+    }
+    getGroupsFor(id) {
+        return this.fetch(url.clientApiGroupsFor(id));
+    }
+    getSuperGroups() {
+        return this.fetch(url.CLIENT_API_SUPER_GROUPS);
+    }
+    getAuthorities() {
+        return this.fetch(url.CLIENT_API_AUTHORITIES);
+    }
+    getAuthoritiesFor(id) {
+        return this.fetch(url.clientApiAuthoritiesFor(id));
+    }
+}
+exports.ClientApi = ClientApi;
+class InfoApi extends ApiClient {
+    getUser(id) {
+        return this.fetch(url.infoApiUser(id));
+    }
+}
+exports.InfoApi = InfoApi;
+class AuthorizationCode extends Client {
+    config;
+    oauth2Client;
+    accessToken;
+    constructor(config) {
+        super();
+        this.config = config;
+        this.oauth2Client = new simple_oauth2_1.default.AuthorizationCode({
+            auth: {
+                tokenHost: url.GAMMA_ROOT,
+                tokenPath: url.TOKEN_PATH,
+                authorizeHost: url.GAMMA_ROOT,
+                authorizePath: url.AUTHORIZE_PATH,
+            },
+            client: {
+                id: this.config.clientId,
+                secret: this.config.clientSecret,
+            },
+            options: {
+                scopeSeparator: ' ',
+            },
+        });
+    }
+    /**
+     * Generate a new access token and store it for later
+     * @param code Authorization code
+     * @returns The generated access token
+     */
+    async generateToken(code) {
+        const token = await this.oauth2Client.getToken({
+            code: code,
+            scope: this.config.scope,
+            redirect_uri: this.config.redirectUri,
+        });
+        this.accessToken = token;
+        return token;
+    }
+    authorizeUrl() {
+        return this.oauth2Client.authorizeURL({
+            scope: this.config.scope,
+            redirect_uri: this.config.redirectUri,
+        });
+    }
+    fetch(url, method = 'GET') {
+        if (!this.accessToken) {
+            throw new Error('No token has been generated yet, make sure to run `generateToken`');
+        }
+        return new Promise((resolve, reject) => {
+            fetch(url, {
+                headers: {
+                    Authorization: `Bearer ${this.accessToken.token.access_token}`,
+                },
+                method: method,
+            })
+                .then(async (res) => {
+                if (!res.ok) {
+                    reject(`Received code ${res.status} during ${method} to ${url}`);
+                    return;
+                }
+                if (!res.headers.has('Content-Type') || res.headers.get('Content-Type') !== 'application/json') {
+                    reject('Response was not JSON');
+                    return;
+                }
+                const data = await res.json();
+                resolve(data);
+            })
+                .catch(reason => {
+                reject(reason);
+            });
+        });
+    }
+    userInfo() {
+        return this.fetch(url.OAUTH2_USERINFO);
+    }
+}
+exports.AuthorizationCode = AuthorizationCode;
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiYXBpLmpzIiwic291cmNlUm9vdCI6IiIsInNvdXJjZXMiOlsiLi4vc3JjL2FwaS50cyJdLCJuYW1lcyI6W10sIm1hcHBpbmdzIjoiOzs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7QUFBQSxrRUFBa0M7QUFFbEMsNENBQTZCO0FBRTdCLE1BQWUsTUFBTTtDQUVwQjtBQU1ELE1BQU0sU0FBVSxTQUFRLE1BQU07SUFDMUIsTUFBTSxDQUFpQjtJQUV2QixZQUFZLE1BQXVCO1FBQy9CLEtBQUssRUFBRSxDQUFBO1FBQ1AsSUFBSSxDQUFDLE1BQU0sR0FBRyxNQUFNLENBQUE7SUFDeEIsQ0FBQztJQUVTLEtBQUssQ0FBbUIsR0FBVyxFQUFFLFNBQWlCLEtBQUs7UUFDakUsT0FBTyxJQUFJLE9BQU8sQ0FBQyxDQUFDLE9BQU8sRUFBRSxNQUFNLEVBQUUsRUFBRTtZQUNuQyxLQUFLLENBQUMsR0FBRyxFQUFFO2dCQUNQLE9BQU8sRUFBRTtvQkFDTCxhQUFhLEVBQUUsSUFBSSxDQUFDLE1BQU0sQ0FBQyxhQUFhO2lCQUMzQztnQkFDRCxNQUFNLEVBQUUsTUFBTTthQUNqQixDQUFDO2lCQUNHLElBQUksQ0FBQyxLQUFLLEVBQUMsR0FBRyxFQUFDLEVBQUU7Z0JBQ2QsSUFBSSxDQUFDLEdBQUcsQ0FBQyxFQUFFLEVBQUUsQ0FBQztvQkFDVixNQUFNLENBQUMsaUJBQWlCLEdBQUcsQ0FBQyxNQUFNLFdBQVcsTUFBTSxPQUFPLEdBQUcsRUFBRSxDQUFDLENBQUE7b0JBQ2hFLE9BQU07Z0JBQ1YsQ0FBQztnQkFFRCxJQUFJLENBQUMsR0FBRyxDQUFDLE9BQU8sQ0FBQyxHQUFHLENBQUMsY0FBYyxDQUFDLElBQUksR0FBRyxDQUFDLE9BQU8sQ0FBQyxHQUFHLENBQUMsY0FBYyxDQUFDLEtBQUssa0JBQWtCLEVBQUUsQ0FBQztvQkFDN0YsTUFBTSxDQUFDLHVCQUF1QixDQUFDLENBQUE7b0JBQy9CLE9BQU07Z0JBQ1YsQ0FBQztnQkFFRCxNQUFNLElBQUksR0FB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

package/lib/index.d.ts

@@ -0,0 +1,3 @@
+export * from './types';
+export * from './api';
+//# sourceMappingURL=index.d.ts.map

package/lib/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,SAAS,CAAA;AACvB,cAAc,OAAO,CAAA"}

package/lib/index.js

@@ -0,0 +1,19 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./types"), exports);
+__exportStar(require("./api"), exports);
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiaW5kZXguanMiLCJzb3VyY2VSb290IjoiIiwic291cmNlcyI6WyIuLi9zcmMvaW5kZXgudHMiXSwibmFtZXMiOltdLCJtYXBwaW5ncyI6Ijs7Ozs7Ozs7Ozs7Ozs7OztBQUFBLDBDQUF1QjtBQUN2Qix3Q0FBcUIifQ==

package/lib/types.d.ts

@@ -0,0 +1,88 @@
+import { UUID } from 'crypto';
+import * as url from './urls';
+export type UserId = UUID;
+export type GroupId = UUID;
+export type SuperGroupId = UUID;
+export type PostId = UUID;
+export interface User {
+    id: UserId;
+    cid: string;
+    nick: string;
+    firstName: string;
+    lastName: string;
+    acceptanceYear: number;
+}
+export interface Group {
+    id: GroupId;
+    name: string;
+    prettyName: string;
+    superGroup: SuperGroup;
+}
+export interface SuperGroup {
+    id: SuperGroupId;
+    name: string;
+    prettyName: string;
+    type: string;
+    svDescription: string;
+    enDescription: string;
+}
+export interface Post extends Versioned {
+    id: PostId;
+    svName: string;
+    enName: string;
+}
+export interface PostInfo extends Post {
+    emailPrefix: string;
+    order: number;
+}
+export interface Versioned {
+    version: number;
+}
+export interface VersionedGroup extends Group, Versioned {
+    superGroup: VersionedSuperGroup;
+}
+export interface VersionedSuperGroup extends SuperGroup, Versioned {
+}
+export type Scope = 'openid' | 'profile' | 'email';
+export interface ClientConfig {
+    clientId: string;
+    clientSecret: string;
+    scope: Scope;
+}
+export type UserAvatarUrl = `${typeof url.IMAGES_USER_AVATAR}/${UserId}`;
+export type GroupAvatarUrl = `${typeof url.IMAGES_GROUP_AVATAR}/${GroupId}`;
+export type GroupBannerUrl = `${typeof url.IMAGES_GROUP_BANNER}/${GroupId}`;
+export type SuperGroupAvatarUrl = `${typeof url.IMAGES_SUPER_GROUP_AVATAR}/${SuperGroupId}`;
+export type SuperGroupBannerUrl = `${typeof url.IMAGES_SUPER_GROUP_BANNER}/${SuperGroupId}`;
+export type ClientApiUserUrl = `${typeof url.CLIENT_API_USERS}/${UserId}`;
+export type ClientApiGroupsForUrl = `${typeof url.CLIENT_API_GROUPS_FOR}/${UserId}`;
+export type ClientApiAuthoritiesForUrl = `${typeof url.CLIENT_API_AUTHORITIES_FOR}/${UserId}`;
+export type InfoApiUserUrl = `${typeof url.INFO_API_USERS}/${UserId}`;
+export interface UserInfo {
+    sub: UserId;
+    cid: string;
+    name: string;
+    given_name: string;
+    family_name: string;
+    nickname: string;
+    picture: UserAvatarUrl;
+    scope: Scope[];
+    iss: typeof url.GAMMA_ROOT;
+    aud: string[];
+    nbf: number;
+    exp: number;
+    iat: number;
+    jti: UUID;
+}
+export interface UserWithGroups {
+    user: User;
+    groups: {
+        group: VersionedGroup;
+        post: PostInfo;
+    }[];
+}
+export interface GroupWithPost extends Group {
+    post: Post;
+}
+export type ClientAuthority = string;
+//# sourceMappingURL=types.d.ts.map

package/lib/types.d.ts.map

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

package/lib/types.js

@@ -0,0 +1,4 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+// #endregion API responses
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoidHlwZXMuanMiLCJzb3VyY2VSb290IjoiIiwic291cmNlcyI6WyIuLi9zcmMvdHlwZXMudHMiXSwibmFtZXMiOltdLCJtYXBwaW5ncyI6Ijs7QUEySEEsMkJBQTJCIn0=

package/lib/urls.d.ts

@@ -0,0 +1,34 @@
+import { ClientApiAuthoritiesForUrl, ClientApiGroupsForUrl, ClientApiUserUrl, GroupAvatarUrl, GroupBannerUrl, GroupId, InfoApiUserUrl, SuperGroupAvatarUrl, SuperGroupBannerUrl, SuperGroupId, UserAvatarUrl, UserId } from './types';
+export declare const GAMMA_ROOT: "https://auth.chalmers.it";
+export declare const OAUTH2_ROOT: "https://auth.chalmers.it/oauth2";
+export declare const AUTHORIZE_PATH: "/oauth2/authorize";
+export declare const AUTHORIZE: "https://auth.chalmers.it/oauth2/authorize";
+export declare const TOKEN_PATH: "/oauth2/token";
+export declare const TOKEN: "https://auth.chalmers.it/oauth2/token";
+export declare const OAUTH2_USERINFO: "https://auth.chalmers.it/oauth2/userinfo";
+export declare const CLIENT_API_ROOT: "https://auth.chalmers.it/api/client/v1";
+export declare const CLIENT_API_GROUPS: "https://auth.chalmers.it/api/client/v1/groups";
+export declare const CLIENT_API_GROUPS_FOR: "https://auth.chalmers.it/api/client/v1/groups/for";
+export declare function clientApiGroupsFor(id: UserId): ClientApiGroupsForUrl;
+export declare const CLIENT_API_SUPER_GROUPS: "https://auth.chalmers.it/api/client/v1/superGroups";
+export declare const CLIENT_API_USERS: "https://auth.chalmers.it/api/client/v1/users";
+export declare function clientApiUser(id: UserId): ClientApiUserUrl;
+export declare const CLIENT_API_AUTHORITIES: "https://auth.chalmers.it/api/client/v1/authorities";
+export declare const CLIENT_API_AUTHORITIES_FOR: "https://auth.chalmers.it/api/client/v1/authorities/for";
+export declare function clientApiAuthoritiesFor(id: UserId): ClientApiAuthoritiesForUrl;
+export declare const INFO_API_ROOT: "https://auth.chalmers.it/api/info/v1";
+export declare const INFO_API_USERS: "https://auth.chalmers.it/api/info/v1/users";
+export declare function infoApiUser(id: UserId): InfoApiUserUrl;
+export declare const INFO_API_BLOB: "https://auth.chalmers.it/api/info/v1/blob";
+export declare const IMAGES: "https://auth.chalmers.it/images";
+export declare const IMAGES_USER_AVATAR: "https://auth.chalmers.it/images/user/avatar";
+export declare function userAvatarUrl(id: UserId): UserAvatarUrl;
+export declare const IMAGES_GROUP_AVATAR: "https://auth.chalmers.it/images/group/avatar";
+export declare function groupAvatarUrl(id: GroupId): GroupAvatarUrl;
+export declare const IMAGES_GROUP_BANNER: "https://auth.chalmers.it/images/group/banner";
+export declare function groupBannerUrl(id: GroupId): GroupBannerUrl;
+export declare const IMAGES_SUPER_GROUP_AVATAR: "https://auth.chalmers.it/images/super-group/avatar";
+export declare function superGroupAvatarUrl(id: SuperGroupId): SuperGroupAvatarUrl;
+export declare const IMAGES_SUPER_GROUP_BANNER: "https://auth.chalmers.it/images/super-group/banner";
+export declare function superGroupBannerUrl(id: SuperGroupId): SuperGroupBannerUrl;
+//# sourceMappingURL=urls.d.ts.map

package/lib/urls.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"urls.d.ts","sourceRoot":"","sources":["../src/urls.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,0BAA0B,EAAE,qBAAqB,EAAE,gBAAgB,EAAE,cAAc,EAAE,cAAc,EAAE,OAAO,EAAE,cAAc,EAAE,mBAAmB,EAAE,mBAAmB,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,EAAE,MAAM,SAAS,CAAA;AAErO,eAAO,MAAM,UAAU,EAAG,0BAAmC,CAAA;AAG7D,eAAO,MAAM,WAAW,mCAAkC,CAAA;AAC1D,eAAO,MAAM,cAAc,EAAG,mBAA4B,CAAA;AAC1D,eAAO,MAAM,SAAS,6CAA4C,CAAA;AAClE,eAAO,MAAM,UAAU,EAAG,eAAwB,CAAA;AAClD,eAAO,MAAM,KAAK,yCAAwC,CAAA;AAI1D,eAAO,MAAM,eAAe,4CAAqC,CAAA;AAIjE,eAAO,MAAM,eAAe,0CAAyC,CAAA;AACrE,eAAO,MAAM,iBAAiB,iDAAuC,CAAA;AACrE,eAAO,MAAM,qBAAqB,qDAAsC,CAAA;AACxE,wBAAgB,kBAAkB,CAAC,EAAE,EAAE,MAAM,GAAG,qBAAqB,CAEpE;AACD,eAAO,MAAM,uBAAuB,sDAA4C,CAAA;AAChF,eAAO,MAAM,gBAAgB,gDAAsC,CAAA;AACnE,wBAAgB,aAAa,CAAC,EAAE,EAAE,MAAM,GAAG,gBAAgB,CAE1D;AACD,eAAO,MAAM,sBAAsB,sDAA4C,CAAA;AAC/E,eAAO,MAAM,0BAA0B,0DAA2C,CAAA;AAClF,wBAAgB,uBAAuB,CAAC,EAAE,EAAE,MAAM,GAAG,0BAA0B,CAE9E;AAID,eAAO,MAAM,aAAa,wCAAuC,CAAA;AACjE,eAAO,MAAM,cAAc,8CAAoC,CAAA;AAC/D,wBAAgB,WAAW,CAAC,EAAE,EAAE,MAAM,GAAG,cAAc,CAEtD;AACD,eAAO,MAAM,aAAa,6CAAmC,CAAA;AAI7D,eAAO,MAAM,MAAM,mCAAkC,CAAA;AACrD,eAAO,MAAM,kBAAkB,+CAAmC,CAAA;AAClE,wBAAgB,aAAa,CAAC,EAAE,EAAE,MAAM,GAAG,aAAa,CAEvD;AACD,eAAO,MAAM,mBAAmB,gDAAoC,CAAA;AACpE,wBAAgB,cAAc,CAAC,EAAE,EAAE,OAAO,GAAG,cAAc,CAE1D;AACD,eAAO,MAAM,mBAAmB,gDAAoC,CAAA;AACpE,wBAAgB,cAAc,CAAC,EAAE,EAAE,OAAO,GAAG,cAAc,CAE1D;AACD,eAAO,MAAM,yBAAyB,sDAA0C,CAAA;AAChF,wBAAgB,mBAAmB,CAAC,EAAE,EAAE,YAAY,GAAG,mBAAmB,CAEzE;AACD,eAAO,MAAM,yBAAyB,sDAA0C,CAAA;AAChF,wBAAgB,mBAAmB,CAAC,EAAE,EAAE,YAAY,GAAG,mBAAmB,CAEzE"}

package/lib/urls.js

@@ -0,0 +1,73 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.IMAGES_SUPER_GROUP_BANNER = exports.IMAGES_SUPER_GROUP_AVATAR = exports.IMAGES_GROUP_BANNER = exports.IMAGES_GROUP_AVATAR = exports.IMAGES_USER_AVATAR = exports.IMAGES = exports.INFO_API_BLOB = exports.INFO_API_USERS = exports.INFO_API_ROOT = exports.CLIENT_API_AUTHORITIES_FOR = exports.CLIENT_API_AUTHORITIES = exports.CLIENT_API_USERS = exports.CLIENT_API_SUPER_GROUPS = exports.CLIENT_API_GROUPS_FOR = exports.CLIENT_API_GROUPS = exports.CLIENT_API_ROOT = exports.OAUTH2_USERINFO = exports.TOKEN = exports.TOKEN_PATH = exports.AUTHORIZE = exports.AUTHORIZE_PATH = exports.OAUTH2_ROOT = exports.GAMMA_ROOT = void 0;
+exports.clientApiGroupsFor = clientApiGroupsFor;
+exports.clientApiUser = clientApiUser;
+exports.clientApiAuthoritiesFor = clientApiAuthoritiesFor;
+exports.infoApiUser = infoApiUser;
+exports.userAvatarUrl = userAvatarUrl;
+exports.groupAvatarUrl = groupAvatarUrl;
+exports.groupBannerUrl = groupBannerUrl;
+exports.superGroupAvatarUrl = superGroupAvatarUrl;
+exports.superGroupBannerUrl = superGroupBannerUrl;
+exports.GAMMA_ROOT = 'https://auth.chalmers.it';
+// #region Authorization
+exports.OAUTH2_ROOT = `${exports.GAMMA_ROOT}/oauth2`;
+exports.AUTHORIZE_PATH = '/oauth2/authorize';
+exports.AUTHORIZE = `${exports.GAMMA_ROOT}${exports.AUTHORIZE_PATH}`;
+exports.TOKEN_PATH = '/oauth2/token';
+exports.TOKEN = `${exports.GAMMA_ROOT}${exports.TOKEN_PATH}`;
+// #endregion Authorization
+// #region OAuth2 Endpoints
+exports.OAUTH2_USERINFO = `${exports.OAUTH2_ROOT}/userinfo`;
+// #endregion
+// #region Client API endpoints
+exports.CLIENT_API_ROOT = `${exports.GAMMA_ROOT}/api/client/v1`;
+exports.CLIENT_API_GROUPS = `${exports.CLIENT_API_ROOT}/groups`;
+exports.CLIENT_API_GROUPS_FOR = `${exports.CLIENT_API_GROUPS}/for`;
+function clientApiGroupsFor(id) {
+    return `${exports.CLIENT_API_GROUPS_FOR}/${id}`;
+}
+exports.CLIENT_API_SUPER_GROUPS = `${exports.CLIENT_API_ROOT}/superGroups`;
+exports.CLIENT_API_USERS = `${exports.CLIENT_API_ROOT}/users`;
+function clientApiUser(id) {
+    return `${exports.CLIENT_API_USERS}/${id}`;
+}
+exports.CLIENT_API_AUTHORITIES = `${exports.CLIENT_API_ROOT}/authorities`;
+exports.CLIENT_API_AUTHORITIES_FOR = `${exports.CLIENT_API_AUTHORITIES}/for`;
+function clientApiAuthoritiesFor(id) {
+    return `${exports.CLIENT_API_AUTHORITIES_FOR}/${id}`;
+}
+// #endregion Client API endpoints
+// #region Info API endpoints
+exports.INFO_API_ROOT = `${exports.GAMMA_ROOT}/api/info/v1`;
+exports.INFO_API_USERS = `${exports.INFO_API_ROOT}/users`;
+function infoApiUser(id) {
+    return `${exports.INFO_API_USERS}/${id}`;
+}
+exports.INFO_API_BLOB = `${exports.INFO_API_ROOT}/blob`;
+// #endregion Info API endpoints
+// #region Images
+exports.IMAGES = `${exports.GAMMA_ROOT}/images`;
+exports.IMAGES_USER_AVATAR = `${exports.IMAGES}/user/avatar`;
+function userAvatarUrl(id) {
+    return `${exports.IMAGES_USER_AVATAR}/${id}`;
+}
+exports.IMAGES_GROUP_AVATAR = `${exports.IMAGES}/group/avatar`;
+function groupAvatarUrl(id) {
+    return `${exports.IMAGES_GROUP_AVATAR}/${id}`;
+}
+exports.IMAGES_GROUP_BANNER = `${exports.IMAGES}/group/banner`;
+function groupBannerUrl(id) {
+    return `${exports.IMAGES_GROUP_BANNER}/${id}`;
+}
+exports.IMAGES_SUPER_GROUP_AVATAR = `${exports.IMAGES}/super-group/avatar`;
+function superGroupAvatarUrl(id) {
+    return `${exports.IMAGES_SUPER_GROUP_AVATAR}/${id}`;
+}
+exports.IMAGES_SUPER_GROUP_BANNER = `${exports.IMAGES}/super-group/banner`;
+function superGroupBannerUrl(id) {
+    return `${exports.IMAGES_SUPER_GROUP_BANNER}/${id}`;
+}
+// #endregion Images
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoidXJscy5qcyIsInNvdXJjZVJvb3QiOiIiLCJzb3VyY2VzIjpbIi4uL3NyYy91cmxzLnRzIl0sIm5hbWVzIjpbXSwibWFwcGluZ3MiOiI7OztBQW9CQSxnREFFQztBQUdELHNDQUVDO0FBR0QsMERBRUM7QUFNRCxrQ0FFQztBQU9ELHNDQUVDO0FBRUQsd0NBRUM7QUFFRCx3Q0FFQztBQUVELGtEQUVDO0FBRUQsa0RBRUM7QUEvRFksUUFBQSxVQUFVLEdBQUcsMEJBQW1DLENBQUE7QUFFN0Qsd0JBQXdCO0FBQ1gsUUFBQSxXQUFXLEdBQUcsR0FBRyxrQkFBVSxTQUFrQixDQUFBO0FBQzdDLFFBQUEsY0FBYyxHQUFHLG1CQUE0QixDQUFBO0FBQzdDLFFBQUEsU0FBUyxHQUFHLEdBQUcsa0JBQVUsR0FBRyxzQkFBYyxFQUFXLENBQUE7QUFDckQsUUFBQSxVQUFVLEdBQUcsZUFBd0IsQ0FBQTtBQUNyQyxRQUFBLEtBQUssR0FBRyxHQUFHLGtCQUFVLEdBQUcsa0JBQVUsRUFBVyxDQUFBO0FBQzFELDJCQUEyQjtBQUUzQiwyQkFBMkI7QUFDZCxRQUFBLGVBQWUsR0FBRyxHQUFHLG1CQUFXLFdBQW9CLENBQUE7QUFDakUsYUFBYTtBQUViLCtCQUErQjtBQUNsQixRQUFBLGVBQWUsR0FBRyxHQUFHLGtCQUFVLGdCQUF5QixDQUFBO0FBQ3hELFFBQUEsaUJBQWlCLEdBQUcsR0FBRyx1QkFBZSxTQUFrQixDQUFBO0FBQ3hELFFBQUEscUJBQXFCLEdBQUcsR0FBRyx5QkFBaUIsTUFBZSxDQUFBO0FBQ3hFLFNBQWdCLGtCQUFrQixDQUFDLEVBQVU7SUFDekMsT0FBTyxHQUFHLDZCQUFxQixJQUFJLEVBQUUsRUFBRSxDQUFBO0FBQzNDLENBQUM7QUFDWSxRQUFBLHVCQUF1QixHQUFHLEdBQUcsdUJBQWUsY0FBdUIsQ0FBQTtBQUNuRSxRQUFBLGdCQUFnQixHQUFHLEdBQUcsdUJBQWUsUUFBaUIsQ0FBQTtBQUNuRSxTQUFnQixhQUFhLENBQUMsRUFBVTtJQUNwQyxPQUFPLEdBQUcsd0JBQWdCLElBQUksRUFBRSxFQUFFLENBQUE7QUFDdEMsQ0FBQztBQUNZLFFBQUEsc0JBQXNCLEdBQUcsR0FBRyx1QkFBZSxjQUF1QixDQUFBO0FBQ2xFLFFBQUEsMEJBQTBCLEdBQUcsR0FBRyw4QkFBc0IsTUFBZSxDQUFBO0FBQ2xGLFNBQWdCLHVCQUF1QixDQUFDLEVBQVU7SUFDOUMsT0FBTyxHQUFHLGtDQUEwQixJQUFJLEVBQUUsRUFBRSxDQUFBO0FBQ2hELENBQUM7QUFDRCxrQ0FBa0M7QUFFbEMsNkJBQTZCO0FBQ2hCLFFBQUEsYUFBYSxHQUFHLEdBQUcsa0JBQVUsY0FBdUIsQ0FBQTtBQUNwRCxRQUFBLGNBQWMsR0FBRyxHQUFHLHFCQUFhLFFBQWlCLENBQUE7QUFDL0QsU0FBZ0IsV0FBVyxDQUFDLEVBQVU7SUFDbEMsT0FBTyxHQUFHLHNCQUFjLElBQUksRUFBRSxFQUFFLENBQUE7QUFDcEMsQ0FBQztBQUNZLFFBQUEsYUFBYSxHQUFHLEdBQUcscUJBQWEsT0FBZ0IsQ0FBQTtBQUM3RCxnQ0FBZ0M7QUFFaEMsaUJBQWlCO0FBQ0osUUFBQSxNQUFNLEdBQUcsR0FBRyxrQkFBVSxTQUFrQixDQUFBO0FBQ3hDLFFBQUEsa0JBQWtCLEdBQUcsR0FBRyxjQUFNLGNBQXVCLENBQUE7QUFDbEUsU0FBZ0IsYUFBYSxDQUFDLEVBQVU7SUFDcEMsT0FBTyxHQUFHLDBCQUFrQixJQUFJLEVBQUUsRUFBRSxDQUFBO0FBQ3hDLENBQUM7QUFDWSxRQUFBLG1CQUFtQixHQUFHLEdBQUcsY0FBTSxlQUF3QixDQUFBO0FBQ3BFLFNBQWdCLGNBQWMsQ0FBQyxFQUFXO0lBQ3RDLE9BQU8sR0FBRywyQkFBbUIsSUFBSSxFQUFFLEVBQUUsQ0FBQTtBQUN6QyxDQUFDO0FBQ1ksUUFBQSxtQkFBbUIsR0FBRyxHQUFHLGNBQU0sZUFBd0IsQ0FBQTtBQUNwRSxTQUFnQixjQUFjLENBQUMsRUFBVztJQUN0QyxPQUFPLEdBQUcsMkJBQW1CLElBQUksRUFBRSxFQUFFLENBQUE7QUFDekMsQ0FBQztBQUNZLFFBQUEseUJBQXlCLEdBQUcsR0FBRyxjQUFNLHFCQUE4QixDQUFBO0FBQ2hGLFNBQWdCLG1CQUFtQixDQUFDLEVBQWdCO0lBQ2hELE9BQU8sR0FBRyxpQ0FBeUIsSUFBSSxFQUFFLEVBQUUsQ0FBQTtBQUMvQyxDQUFDO0FBQ1ksUUFBQSx5QkFBeUIsR0FBRyxHQUFHLGNBQU0scUJBQThCLENBQUE7QUFDaEYsU0FBZ0IsbUJBQW1CLENBQUMsRUFBZ0I7SUFDaEQsT0FBTyxHQUFHLGlDQUF5QixJQUFJLEVBQUUsRUFBRSxDQUFBO0FBQy9DLENBQUM7QUFDRCxvQkFBb0IifQ==

package/package.json

@@ -0,0 +1,51 @@
+{
+  "name": "gammait",
+  "version": "1.0.0",
+  "description": "Interact with the IT-sections account system",
+  "main": "lib/index.js",
+  "types": "lib/index.d.ts",
+  "files": [
+    "/lib",
+    "/src"
+  ],
+  "exports": {
+    ".": {
+      "import": "./lib/index.js",
+      "require": "./lib/index.js",
+      "types": "./lib/index.d.ts"
+    },
+    "./urls": {
+      "import": "./lib/urls.js",
+      "require": "./lib/urls.js",
+      "types": "./lib/urls.d.ts"
+    }
+  },
+  "scripts": {
+    "build": "rimraf lib && tsc",
+    "test": "echo \"Error: no test specified\" && exit 1"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/olillin/gammait.git"
+  },
+  "keywords": [
+    "oauth2",
+    "gamma",
+    "chalmers"
+  ],
+  "author": "Oli <oli@olillin.com>",
+  "license": "MIT",
+  "bugs": {
+    "url": "https://github.com/olillin/gammait/issues"
+  },
+  "homepage": "https://github.com/olillin/gammait#readme",
+  "dependencies": {
+    "simple-oauth2": "^5.1.0",
+    "typescript": "^5.7.3"
+  },
+  "devDependencies": {
+    "@types/node": "^22.13.1",
+    "@types/simple-oauth2": "^5.0.7",
+    "rimraf": "^6.0.1"
+  }
+}

package/src/api.ts

@@ -0,0 +1,179 @@
+import oauth2 from 'simple-oauth2'
+import { ClientAuthority, Group, GroupWithPost, Scope, SuperGroup, User, UserId, UserInfo, UserWithGroups } from './types'
+import * as url from './urls'
+
+abstract class Client {
+    protected abstract fetch<T extends object>(url: string, method: string): Promise<T>
+}
+
+interface ApiClientConfig {
+    authorization: string
+}
+
+class ApiClient extends Client {
+    config: ApiClientConfig
+
+    constructor(config: ApiClientConfig) {
+        super()
+        this.config = config
+    }
+
+    protected fetch<T extends object>(url: string, method: string = 'GET'): Promise<T> {
+        return new Promise((resolve, reject) => {
+            fetch(url, {
+                headers: {
+                    Authorization: this.config.authorization,
+                },
+                method: method,
+            })
+                .then(async res => {
+                    if (!res.ok) {
+                        reject(`Received code ${res.status} during ${method} to ${url}`)
+                        return
+                    }
+
+                    if (!res.headers.has('Content-Type') || res.headers.get('Content-Type') !== 'application/json') {
+                        reject('Response was not JSON')
+                        return
+                    }
+
+                    const data: T = await res.json()
+                    resolve(data)
+                })
+                .catch(reason => {
+                    reject(reason)
+                })
+        })
+    }
+}
+
+export class ClientApi extends ApiClient {
+    getUsers(): Promise<User[]> {
+        return this.fetch(url.CLIENT_API_USERS)
+    }
+
+    getUser(id: UserId): Promise<User> {
+        return this.fetch(url.clientApiUser(id))
+    }
+
+    getGroups(): Promise<Group[]> {
+        return this.fetch(url.CLIENT_API_GROUPS)
+    }
+
+    getGroupsFor(id: UserId): Promise<GroupWithPost[]> {
+        return this.fetch(url.clientApiGroupsFor(id))
+    }
+
+    getSuperGroups(): Promise<SuperGroup[]> {
+        return this.fetch(url.CLIENT_API_SUPER_GROUPS)
+    }
+
+    getAuthorities(): Promise<ClientAuthority[]> {
+        return this.fetch(url.CLIENT_API_AUTHORITIES)
+    }
+
+    getAuthoritiesFor(id: UserId): Promise<ClientAuthority[]> {
+        return this.fetch(url.clientApiAuthoritiesFor(id))
+    }
+}
+
+export class InfoApi extends ApiClient {
+    getUser(id: UserId): Promise<UserWithGroups> {
+        return this.fetch(url.infoApiUser(id))
+    }
+
+    // getBlob(): Promise<unknown> {
+    //     return this.fetch(url.INFO_API_BLOB)
+    // }
+}
+
+export interface AuthorizationCodeConfig {
+    clientId: string
+    clientSecret: string
+    redirectUri: string
+    scope: Scope[]
+}
+
+export class AuthorizationCode extends Client {
+    config: AuthorizationCodeConfig
+    oauth2Client: oauth2.AuthorizationCode
+    accessToken: oauth2.AccessToken | undefined
+
+    constructor(config: AuthorizationCodeConfig) {
+        super()
+        this.config = config
+        this.oauth2Client = new oauth2.AuthorizationCode({
+            auth: {
+                tokenHost: url.GAMMA_ROOT,
+                tokenPath: url.TOKEN_PATH,
+                authorizeHost: url.GAMMA_ROOT,
+                authorizePath: url.AUTHORIZE_PATH,
+            },
+            client: {
+                id: this.config.clientId,
+                secret: this.config.clientSecret,
+            },
+            options: {
+                scopeSeparator: ' ',
+            },
+        })
+    }
+
+    /**
+     * Generate a new access token and store it for later
+     * @param code Authorization code
+     * @returns The generated access token
+     */
+    async generateToken(code: string): Promise<oauth2.AccessToken> {
+        const token = await this.oauth2Client.getToken({
+            code: code,
+            scope: this.config.scope,
+            redirect_uri: this.config.redirectUri,
+        })
+        this.accessToken = token
+        return token
+    }
+
+    authorizeUrl() {
+        return this.oauth2Client.authorizeURL({
+            scope: this.config.scope,
+            redirect_uri: this.config.redirectUri,
+        })
+    }
+
+    protected fetch<T extends object>(url: string, method: string = 'GET'): Promise<T> {
+        if (!this.accessToken) {
+            throw new Error('No token has been generated yet, make sure to run `generateToken`')
+        }
+
+        return new Promise((resolve, reject) => {
+            fetch(url, {
+                headers: {
+                    Authorization: `Bearer ${this.accessToken!.token.access_token}`,
+                },
+                method: method,
+            })
+                .then(async res => {
+                    if (!res.ok) {
+                        reject(`Received code ${res.status} during ${method} to ${url}`)
+                        return
+                    }
+
+                    if (!res.headers.has('Content-Type') || res.headers.get('Content-Type') !== 'application/json') {
+                        reject('Response was not JSON')
+                        return
+                    }
+
+                    const data: T = await res.json()
+                    resolve(data)
+                })
+                .catch(reason => {
+                    reject(reason)
+                })
+        })
+    }
+
+    userInfo(): Promise<UserInfo> {
+        return this.fetch(url.OAUTH2_USERINFO)
+    }
+}

package/src/index.ts

@@ -0,0 +1,2 @@
+export * from './types'
+export * from './api'

package/src/types.ts

@@ -0,0 +1,124 @@
+import { UUID } from 'crypto'
+import * as url from './urls'
+
+// #region Basic
+export type UserId = UUID
+export type GroupId = UUID
+export type SuperGroupId = UUID
+export type PostId = UUID
+
+export interface User {
+    id: UserId
+    cid: string
+    nick: string
+    firstName: string
+    lastName: string
+    acceptanceYear: number
+}
+
+export interface Group {
+    id: GroupId
+    name: string
+    prettyName: string
+    superGroup: SuperGroup
+}
+
+export interface SuperGroup {
+    id: SuperGroupId
+    name: string
+    prettyName: string
+    type: string
+    svDescription: string
+    enDescription: string
+}
+
+export interface Post extends Versioned {
+    id: PostId
+    svName: string
+    enName: string
+}
+
+export interface PostInfo extends Post {
+    emailPrefix: string
+    order: number
+}
+
+export interface Versioned {
+    version: number
+}
+
+export interface VersionedGroup extends Group, Versioned {
+    superGroup: VersionedSuperGroup
+}
+
+export interface VersionedSuperGroup extends SuperGroup, Versioned {}
+
+// #endregion Basic
+
+// #region Authentication
+export type Scope = 'openid' | 'profile' | 'email'
+
+export interface ClientConfig {
+    clientId: string
+    clientSecret: string
+    scope: Scope
+}
+// #endregion Authentication
+
+// #region URLs
+
+// #region Images
+export type UserAvatarUrl = `${typeof url.IMAGES_USER_AVATAR}/${UserId}`
+export type GroupAvatarUrl = `${typeof url.IMAGES_GROUP_AVATAR}/${GroupId}`
+export type GroupBannerUrl = `${typeof url.IMAGES_GROUP_BANNER}/${GroupId}`
+export type SuperGroupAvatarUrl = `${typeof url.IMAGES_SUPER_GROUP_AVATAR}/${SuperGroupId}`
+export type SuperGroupBannerUrl = `${typeof url.IMAGES_SUPER_GROUP_BANNER}/${SuperGroupId}`
+// #endregion Images
+
+// #region Client API
+export type ClientApiUserUrl = `${typeof url.CLIENT_API_USERS}/${UserId}`
+export type ClientApiGroupsForUrl = `${typeof url.CLIENT_API_GROUPS_FOR}/${UserId}`
+export type ClientApiAuthoritiesForUrl = `${typeof url.CLIENT_API_AUTHORITIES_FOR}/${UserId}`
+// #endregion Client API
+
+// #region Info API
+export type InfoApiUserUrl = `${typeof url.INFO_API_USERS}/${UserId}`
+// #endregion Info API
+
+// #endregion URLs
+
+// #region API responses
+export interface UserInfo {
+    sub: UserId
+    cid: string
+
+    name: string
+    given_name: string
+    family_name: string
+    nickname: string
+    picture: UserAvatarUrl
+
+    scope: Scope[]
+    iss: typeof url.GAMMA_ROOT
+
+    aud: string[]
+    nbf: number
+    exp: number
+    iat: number
+    jti: UUID
+}
+
+export interface UserWithGroups {
+    user: User
+    groups: {
+        group: VersionedGroup
+        post: PostInfo
+    }[]
+}
+
+export interface GroupWithPost extends Group {
+    post: Post
+}
+
+export type ClientAuthority = string
+// #endregion API responses

package/src/urls.ts

@@ -0,0 +1,67 @@
+import { ClientApiAuthoritiesForUrl, ClientApiGroupsForUrl, ClientApiUserUrl, GroupAvatarUrl, GroupBannerUrl, GroupId, InfoApiUserUrl, SuperGroupAvatarUrl, SuperGroupBannerUrl, SuperGroupId, UserAvatarUrl, UserId } from './types'
+
+export const GAMMA_ROOT = 'https://auth.chalmers.it' as const
+
+// #region Authorization
+export const OAUTH2_ROOT = `${GAMMA_ROOT}/oauth2` as const
+export const AUTHORIZE_PATH = '/oauth2/authorize' as const
+export const AUTHORIZE = `${GAMMA_ROOT}${AUTHORIZE_PATH}` as const
+export const TOKEN_PATH = '/oauth2/token' as const
+export const TOKEN = `${GAMMA_ROOT}${TOKEN_PATH}` as const
+// #endregion Authorization
+
+// #region OAuth2 Endpoints
+export const OAUTH2_USERINFO = `${OAUTH2_ROOT}/userinfo` as const
+// #endregion
+
+// #region Client API endpoints
+export const CLIENT_API_ROOT = `${GAMMA_ROOT}/api/client/v1` as const
+export const CLIENT_API_GROUPS = `${CLIENT_API_ROOT}/groups` as const
+export const CLIENT_API_GROUPS_FOR = `${CLIENT_API_GROUPS}/for` as const
+export function clientApiGroupsFor(id: UserId): ClientApiGroupsForUrl {
+    return `${CLIENT_API_GROUPS_FOR}/${id}`
+}
+export const CLIENT_API_SUPER_GROUPS = `${CLIENT_API_ROOT}/superGroups` as const
+export const CLIENT_API_USERS = `${CLIENT_API_ROOT}/users` as const
+export function clientApiUser(id: UserId): ClientApiUserUrl {
+    return `${CLIENT_API_USERS}/${id}`
+}
+export const CLIENT_API_AUTHORITIES = `${CLIENT_API_ROOT}/authorities` as const
+export const CLIENT_API_AUTHORITIES_FOR = `${CLIENT_API_AUTHORITIES}/for` as const
+export function clientApiAuthoritiesFor(id: UserId): ClientApiAuthoritiesForUrl {
+    return `${CLIENT_API_AUTHORITIES_FOR}/${id}`
+}
+// #endregion Client API endpoints
+
+// #region Info API endpoints
+export const INFO_API_ROOT = `${GAMMA_ROOT}/api/info/v1` as const
+export const INFO_API_USERS = `${INFO_API_ROOT}/users` as const
+export function infoApiUser(id: UserId): InfoApiUserUrl {
+    return `${INFO_API_USERS}/${id}`
+}
+export const INFO_API_BLOB = `${INFO_API_ROOT}/blob` as const
+// #endregion Info API endpoints
+
+// #region Images
+export const IMAGES = `${GAMMA_ROOT}/images` as const
+export const IMAGES_USER_AVATAR = `${IMAGES}/user/avatar` as const
+export function userAvatarUrl(id: UserId): UserAvatarUrl {
+    return `${IMAGES_USER_AVATAR}/${id}`
+}
+export const IMAGES_GROUP_AVATAR = `${IMAGES}/group/avatar` as const
+export function groupAvatarUrl(id: GroupId): GroupAvatarUrl {
+    return `${IMAGES_GROUP_AVATAR}/${id}`
+}
+export const IMAGES_GROUP_BANNER = `${IMAGES}/group/banner` as const
+export function groupBannerUrl(id: GroupId): GroupBannerUrl {
+    return `${IMAGES_GROUP_BANNER}/${id}`
+}
+export const IMAGES_SUPER_GROUP_AVATAR = `${IMAGES}/super-group/avatar` as const
+export function superGroupAvatarUrl(id: SuperGroupId): SuperGroupAvatarUrl {
+    return `${IMAGES_SUPER_GROUP_AVATAR}/${id}`
+}
+export const IMAGES_SUPER_GROUP_BANNER = `${IMAGES}/super-group/banner` as const
+export function superGroupBannerUrl(id: SuperGroupId): SuperGroupBannerUrl {
+    return `${IMAGES_SUPER_GROUP_BANNER}/${id}`
+}
+// #endregion Images