@axium/client 0.1.0 → 0.1.1

package/dist/index.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/index.js

@@ -0,0 +1 @@
+export {};

package/dist/requests.d.ts

@@ -0,0 +1,7 @@
+import type { RequestMethod } from '@axium/core/requests';
+import type { Endpoint, RequestBody, Result, APIParameters } from '@axium/core/api';
+export declare let token: string | null;
+export declare function setToken(value: string | null): void;
+export declare let prefix: string;
+export declare function setPrefix(value: string): void;
+export declare function fetchAPI<const M extends RequestMethod, const E extends Endpoint>(method: M, endpoint: E, data?: RequestBody<M, E>, ...params: APIParameters<E>): Promise<Result<M, E>>;

package/dist/requests.js

@@ -0,0 +1,40 @@
+export let token = null;
+export function setToken(value) {
+    token = value;
+}
+export let prefix = '/api/';
+export function setPrefix(value) {
+    prefix = value;
+}
+export async function fetchAPI(method, endpoint, data, ...params) {
+    const options = {
+        method,
+        headers: {
+            'Content-Type': 'application/json',
+            Accept: 'application/json',
+        },
+    };
+    if (method !== 'GET' && method !== 'HEAD')
+        options.body = JSON.stringify(data);
+    if (token)
+        options.headers.Authorization = 'Bearer ' + token;
+    const parts = [];
+    for (const part of endpoint.split('/')) {
+        if (!part.startsWith(':')) {
+            parts.push(part);
+            continue;
+        }
+        const value = params.shift();
+        if (!value)
+            throw new Error(`Missing parameter "${part.slice(1)}"`);
+        parts.push(value);
+    }
+    const response = await fetch(prefix + parts.join('/'), options);
+    if (!response.headers.get('Content-Type')?.includes('application/json')) {
+        throw new Error(`Unexpected response type: ${response.headers.get('Content-Type')}`);
+    }
+    const json = await response.json().catch(() => ({ message: 'Unknown server error (invalid JSON response)' }));
+    if (!response.ok)
+        throw new Error(json.message);
+    return json;
+}

package/dist/user.d.ts

@@ -0,0 +1,32 @@
+import z from 'zod/v4';
+import { type PasskeyChangeable } from '@axium/core';
+export declare function login(userId: string): Promise<import("@axium/core").NewSessionResponse>;
+/**
+ * Create an elevated session for the user to perform sensitive actions.
+ */
+export declare function elevate(userId: string): Promise<void>;
+export declare function loginByEmail(email: string): Promise<import("@axium/core").NewSessionResponse>;
+export declare function getCurrentSession(): Promise<import("@axium/core").Session & {
+    user: import("@axium/core").User;
+}>;
+export declare function getSessions(userId: string): Promise<import("@axium/core").Session[]>;
+export declare function logout(userId: string, ...sessionId: string[]): Promise<import("@axium/core").Session[]>;
+export declare function logoutAll(userId: string): Promise<import("@axium/core").Session[]>;
+export declare function logoutCurrentSession(): Promise<import("@axium/core").Session>;
+export declare function register(_data: Record<string, FormDataEntryValue>): Promise<void>;
+export declare function userInfo(userId: string): Promise<import("@axium/core").UserPublic & Partial<import("@axium/core").User>>;
+export declare function updateUser(userId: string, data: Record<string, FormDataEntryValue>): Promise<import("@axium/core").User>;
+export declare function fullUserInfo(userId: string): Promise<import("@axium/core").User & {
+    sessions: import("@axium/core").Session[];
+}>;
+export declare function deleteUser(userId: string): Promise<import("@axium/core").User>;
+export declare function emailVerificationEnabled(userId: string): Promise<boolean>;
+export declare function sendVerificationEmail(userId: string): Promise<import("@axium/core").Verification>;
+export declare function verifyEmail(userId: string, token: string): Promise<{}>;
+export declare function getPasskeys(userId: string): Promise<import("@axium/core").Passkey[]>;
+/**
+ * Create a new passkey for an existing user.
+ */
+export declare function createPasskey(userId: string): Promise<import("@axium/core").Passkey>;
+export declare function updatePasskey(passkeyId: string, data: z.input<typeof PasskeyChangeable>): Promise<import("@axium/core").Passkey>;
+export declare function deletePasskey(passkeyId: string): Promise<import("@axium/core").Passkey>;

package/dist/user.js

@@ -0,0 +1,145 @@
+import { startAuthentication, startRegistration } from '@simplewebauthn/browser';
+import z from 'zod/v4';
+import { fetchAPI } from './requests.js';
+import { UserChangeable } from '@axium/core';
+export async function login(userId) {
+    const options = await fetchAPI('OPTIONS', 'users/:id/auth', { type: 'login' }, userId);
+    const response = await startAuthentication({ optionsJSON: options });
+    return await fetchAPI('POST', 'users/:id/auth', response, userId);
+}
+/**
+ * Create an elevated session for the user to perform sensitive actions.
+ */
+export async function elevate(userId) {
+    const options = await fetchAPI('OPTIONS', 'users/:id/auth', { type: 'action' }, userId);
+    const response = await startAuthentication({ optionsJSON: options });
+    await fetchAPI('POST', 'users/:id/auth', response, userId);
+}
+export async function loginByEmail(email) {
+    const { id: userId } = await fetchAPI('POST', 'user_id', {
+        using: 'email',
+        value: email,
+    });
+    return await login(userId);
+}
+export async function getCurrentSession() {
+    const result = await fetchAPI('GET', 'session');
+    result.created = new Date(result.created);
+    result.expires = new Date(result.expires);
+    return result;
+}
+export async function getSessions(userId) {
+    _checkId(userId);
+    const result = await fetchAPI('GET', 'users/:id/sessions', {}, userId);
+    for (const session of result) {
+        session.created = new Date(session.created);
+        session.expires = new Date(session.expires);
+    }
+    return result;
+}
+export async function logout(userId, ...sessionId) {
+    _checkId(userId);
+    const result = await fetchAPI('DELETE', 'users/:id/sessions', { id: sessionId }, userId);
+    for (const session of result) {
+        session.created = new Date(session.created);
+        session.expires = new Date(session.expires);
+    }
+    return result;
+}
+export async function logoutAll(userId) {
+    _checkId(userId);
+    await elevate(userId);
+    const result = await fetchAPI('DELETE', 'users/:id/sessions', { confirm_all: true }, userId);
+    for (const session of result) {
+        session.created = new Date(session.created);
+        session.expires = new Date(session.expires);
+    }
+    return result;
+}
+export async function logoutCurrentSession() {
+    return await fetchAPI('DELETE', 'session');
+}
+export async function register(_data) {
+    const data = z.object({ name: z.string(), email: z.email() }).parse(_data);
+    const { options, userId } = await fetchAPI('OPTIONS', 'register', data);
+    const response = await startRegistration({ optionsJSON: options });
+    await fetchAPI('POST', 'register', {
+        userId,
+        name: data.name,
+        email: data.email,
+        response,
+    });
+}
+function _checkId(userId) {
+    try {
+        z.uuid().parse(userId);
+    }
+    catch (e) {
+        throw z.prettifyError(e);
+    }
+}
+export async function userInfo(userId) {
+    _checkId(userId);
+    return await fetchAPI('GET', 'users/:id', {}, userId);
+}
+export async function updateUser(userId, data) {
+    _checkId(userId);
+    const body = await UserChangeable.parseAsync(data).catch(e => {
+        throw z.prettifyError(e);
+    });
+    const result = await fetchAPI('PATCH', 'users/:id', body, userId);
+    if (result.emailVerified)
+        result.emailVerified = new Date(result.emailVerified);
+    return result;
+}
+export async function fullUserInfo(userId) {
+    _checkId(userId);
+    const result = await fetchAPI('GET', 'users/:id/full', {}, userId);
+    result.emailVerified = new Date(result.emailVerified);
+    return result;
+}
+export async function deleteUser(userId) {
+    _checkId(userId);
+    const options = await fetchAPI('OPTIONS', 'users/:id/auth', { type: 'action' }, userId);
+    const response = await startAuthentication({ optionsJSON: options });
+    await fetchAPI('POST', 'users/:id/auth', response, userId);
+    const result = await fetchAPI('DELETE', 'users/:id', response, userId);
+    result.emailVerified = new Date(result.emailVerified);
+    return result;
+}
+export async function emailVerificationEnabled(userId) {
+    _checkId(userId);
+    const { enabled } = await fetchAPI('OPTIONS', 'users/:id/verify_email', {}, userId);
+    return enabled;
+}
+export async function sendVerificationEmail(userId) {
+    _checkId(userId);
+    return await fetchAPI('GET', 'users/:id/verify_email', {}, userId);
+}
+export async function verifyEmail(userId, token) {
+    _checkId(userId);
+    return await fetchAPI('POST', 'users/:id/verify_email', { token }, userId);
+}
+export async function getPasskeys(userId) {
+    _checkId(userId);
+    const result = await fetchAPI('GET', 'users/:id/passkeys', {}, userId);
+    for (const passkey of result) {
+        passkey.createdAt = new Date(passkey.createdAt);
+    }
+    return result;
+}
+/**
+ * Create a new passkey for an existing user.
+ */
+export async function createPasskey(userId) {
+    _checkId(userId);
+    const options = await fetchAPI('OPTIONS', 'users/:id/passkeys', {}, userId);
+    const response = await startRegistration({ optionsJSON: options });
+    return await fetchAPI('PUT', 'users/:id/passkeys', response, userId);
+}
+export async function updatePasskey(passkeyId, data) {
+    return await fetchAPI('PATCH', 'passkeys/:id', data, passkeyId);
+}
+export async function deletePasskey(passkeyId) {
+    return await fetchAPI('DELETE', 'passkeys/:id', {}, passkeyId);
+}

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@axium/client",
-	"version": "0.1.0",
+	"version": "0.1.1",
 	"author": "James Prevett <jp@jamespre.dev>",
 	"funding": {
 		"type": "individual",