Skip to content

Every analytics tool wants a subscription. And your data. I built Twiligent instead. YouTube stats. Instagram stats. One dashboard. Runs locally on your machine.

2.7 KB
Raw Blame
// state format: base64url(userId:timestamp).base64url(hmac-sha256 signature)
const STATE_TTL_MS = 10 * 60 * 1000;

function toBase64Url(text: string): string {
    return btoa(text).replace(/\+/g, '-').replace(/\//g, '_').replace(/=+$/, '');
}

function hmacKey(secret: string, usage: 'sign' | 'verify'): Promise<CryptoKey> {
    return crypto.subtle.importKey('raw', new TextEncoder().encode(secret), { name: 'HMAC', hash: 'SHA-256' }, false, [usage]);
}

async function hmacSign(secret: string, message: string): Promise<string> {
    const signature = await crypto.subtle.sign('HMAC', await hmacKey(secret, 'sign'), new TextEncoder().encode(message));
    return toBase64Url(String.fromCharCode(...new Uint8Array(signature)));
}

function fromBase64Url(text: string): Uint8Array<ArrayBuffer> | null {
    try {
        return Uint8Array.from(atob(text.replace(/-/g, '+').replace(/_/g, '/')), char => char.charCodeAt(0));
    } catch {
        // a tampered state is not valid base64
        return null;
    }
}

// subtle.verify compares in constant time, unlike comparing the two signatures as strings
async function hmacVerify(secret: string, message: string, signature: string): Promise<boolean> {
    const signatureBytes = fromBase64Url(signature);
    if (!signatureBytes) return false;
    return crypto.subtle.verify('HMAC', await hmacKey(secret, 'verify'), signatureBytes, new TextEncoder().encode(message));
}

// the subject names what the sign-in is for, such as the account it was started from; ids never contain a colon
export async function createOAuthState(userId: string, secret: string, subject = ''): Promise<string> {
    const payload = toBase64Url(subject ? `${userId}:${Date.now()}:${subject}` : `${userId}:${Date.now()}`);
    const signature = await hmacSign(secret, payload);
    return `${payload}.${signature}`;
}

export interface OAuthStateDetails {
    userId: string;
    subject: string | null;
}

export async function readOAuthState(state: string, secret: string): Promise<OAuthStateDetails | null> {
    const separatorIndex = state.lastIndexOf('.');
    if (separatorIndex === -1) return null;

    const payload = state.slice(0, separatorIndex);
    const signature = state.slice(separatorIndex + 1);
    const isValid = await hmacVerify(secret, payload, signature);
    if (!isValid) return null;

    const decoded = fromBase64Url(payload);
    if (!decoded) return null;
    const [userId, createdAt, subject] = new TextDecoder().decode(decoded).split(':');
    if (Date.now() - Number(createdAt) > STATE_TTL_MS) return null;

    return { userId, subject: subject || null };
}

export async function verifyOAuthState(state: string, secret: string): Promise<string | null> {
    return (await readOAuthState(state, secret))?.userId ?? null;
}