local-lite 0.0.12 → 0.0.15

package/dist/auth/apple.js

@@ -0,0 +1,264 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AppleAuthClient = exports.DEFAULT_APPLE_AUTH_SCOPES = exports.APPLE_TOKEN_ENDPOINT = exports.APPLE_AUTHORIZATION_ENDPOINT = void 0;
+exports.createInMemoryAppleTokenStore = createInMemoryAppleTokenStore;
+exports.createAppleAuthTokenStore = createAppleAuthTokenStore;
+exports.APPLE_AUTHORIZATION_ENDPOINT = 'https://appleid.apple.com/auth/authorize';
+exports.APPLE_TOKEN_ENDPOINT = 'https://appleid.apple.com/auth/token';
+exports.DEFAULT_APPLE_AUTH_SCOPES = ['name', 'email'];
+function secureRandomBytes(length) {
+    const crypto = globalThis.crypto;
+    if (!crypto?.getRandomValues) {
+        throw new Error('Secure random number generation is unavailable.');
+    }
+    return crypto.getRandomValues(new Uint8Array(length));
+}
+function base64UrlEncode(bytes) {
+    const alphabet = 'ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz0123456789-_';
+    let result = '';
+    for (let index = 0; index < bytes.length; index += 3) {
+        const first = bytes[index];
+        const second = bytes[index + 1];
+        const third = bytes[index + 2];
+        result += alphabet[first >> 2];
+        result += alphabet[((first & 3) << 4) | (second === undefined ? 0 : second >> 4)];
+        if (second !== undefined) {
+            result += alphabet[((second & 15) << 2) | (third === undefined ? 0 : third >> 6)];
+        }
+        if (third !== undefined)
+            result += alphabet[third & 63];
+    }
+    return result;
+}
+function parseJwtClaims(jwt) {
+    try {
+        const parts = jwt.split('.');
+        if (parts.length < 2)
+            return {};
+        let base64 = parts[1].replace(/-/g, '+').replace(/_/g, '/');
+        while (base64.length % 4) {
+            base64 += '=';
+        }
+        const json = typeof atob === 'function'
+            ? atob(base64)
+            : Buffer.from(base64, 'base64').toString('utf8');
+        return JSON.parse(json);
+    }
+    catch {
+        return {};
+    }
+}
+function validateTokens(value) {
+    if (!value || typeof value !== 'object')
+        return false;
+    const tokens = value;
+    return typeof tokens.idToken === 'string';
+}
+function validateUser(value) {
+    if (!value || typeof value !== 'object')
+        return false;
+    const user = value;
+    return typeof user.id === 'string' && typeof user.email === 'string';
+}
+function createInMemoryAppleTokenStore() {
+    let storedTokens = null;
+    let storedUser = null;
+    return {
+        getTokens: async () => storedTokens,
+        setTokens: async (tokens) => {
+            storedTokens = tokens;
+        },
+        removeTokens: async () => {
+            storedTokens = null;
+        },
+        getUser: async () => storedUser,
+        setUser: async (user) => {
+            storedUser = user;
+        },
+    };
+}
+function createAppleAuthTokenStore(storage, prefix = 'local-lite-apple-auth') {
+    const tokensKey = `${prefix}-tokens`;
+    const userKey = `${prefix}-user`;
+    return {
+        getTokens: async () => {
+            const raw = await storage.getItem(tokensKey);
+            return validateTokens(raw) ? raw : null;
+        },
+        setTokens: tokens => storage.setItem(tokensKey, tokens),
+        removeTokens: () => storage.removeItem(tokensKey),
+        getUser: async () => {
+            const raw = await storage.getItem(userKey);
+            return validateUser(raw) ? raw : null;
+        },
+        setUser: async (user) => {
+            if (user) {
+                await storage.setItem(userKey, user);
+            }
+            else {
+                await storage.removeItem(userKey);
+            }
+        },
+    };
+}
+class AppleAuthClient {
+    options;
+    tokenStore;
+    listeners = new Set();
+    currentUser = null;
+    constructor(options) {
+        this.options = options;
+        if (!options.clientId?.trim()) {
+            throw new Error('Apple OAuth client ID (Service ID or App Bundle ID) is required.');
+        }
+        if (options.tokenStore) {
+            this.tokenStore = options.tokenStore;
+        }
+        else if (options.storage) {
+            this.tokenStore = createAppleAuthTokenStore(options.storage);
+        }
+        else {
+            this.tokenStore = createInMemoryAppleTokenStore();
+        }
+    }
+    onAuthStateChange(listener) {
+        this.listeners.add(listener);
+        return () => {
+            this.listeners.delete(listener);
+        };
+    }
+    notify(user) {
+        this.currentUser = user;
+        for (const listener of this.listeners) {
+            try {
+                listener(user);
+            }
+            catch (err) {
+                console.error('Error in AppleAuthClient listener:', err);
+            }
+        }
+    }
+    /**
+     * Signs in with Apple.
+     * If a native credential object (from expo-apple-authentication or native ASAuthorizationAppleIDCredential)
+     * is passed, processes and verifies it directly.
+     * Otherwise, launches the PKCE web/browser authorization flow.
+     */
+    async signIn(nativeCredential) {
+        if (nativeCredential) {
+            return this.processNativeCredential(nativeCredential);
+        }
+        if (!this.options.authorize) {
+            throw new Error('AppleAuthClient requires an authorize callback for web/browser authorization, or a native credential passed to signIn().');
+        }
+        if (!this.options.redirectUri) {
+            throw new Error('Apple OAuth redirectUri is required for web authorization flow.');
+        }
+        const randomBytes = this.options.randomBytes ?? secureRandomBytes;
+        const state = base64UrlEncode(randomBytes(32));
+        const nonce = base64UrlEncode(randomBytes(32));
+        const scopes = this.options.scopes && this.options.scopes.length > 0
+            ? this.options.scopes.join(' ')
+            : exports.DEFAULT_APPLE_AUTH_SCOPES.join(' ');
+        const params = new URLSearchParams({
+            client_id: this.options.clientId,
+            redirect_uri: this.options.redirectUri,
+            response_type: 'code id_token',
+            response_mode: 'form_post',
+            scope: scopes,
+            state,
+            nonce,
+        });
+        const authorization = await this.options.authorize({
+            authorizationUrl: `${exports.APPLE_AUTHORIZATION_ENDPOINT}?${params.toString()}`,
+            redirectUri: this.options.redirectUri,
+            state,
+            nonce,
+        });
+        if (!authorization) {
+            return null;
+        }
+        if (authorization.state && authorization.state !== state) {
+            throw new Error('Apple OAuth state validation failed. Please try connecting again.');
+        }
+        if (!authorization.id_token) {
+            throw new Error('Apple OAuth did not return an id_token.');
+        }
+        const claims = parseJwtClaims(authorization.id_token);
+        const id = claims.sub || 'apple-user';
+        const email = claims.email || authorization.user?.email || `${id}@privaterelay.appleid.com`;
+        const givenName = authorization.user?.name?.firstName;
+        const familyName = authorization.user?.name?.lastName;
+        const nameParts = [givenName, familyName].filter(Boolean);
+        const name = nameParts.length > 0 ? nameParts.join(' ') : email.split('@')[0];
+        const tokens = {
+            idToken: authorization.id_token,
+            expiresAt: claims.exp ? claims.exp * 1000 : undefined,
+        };
+        await this.tokenStore.setTokens(tokens);
+        const user = {
+            id,
+            email,
+            name,
+            givenName,
+            familyName,
+            identityToken: authorization.id_token,
+            authorizationCode: authorization.code,
+        };
+        await this.tokenStore.setUser(user);
+        this.notify(user);
+        return user;
+    }
+    async processNativeCredential(cred) {
+        const claims = cred.identityToken ? parseJwtClaims(cred.identityToken) : {};
+        const id = cred.user || claims.sub;
+        const email = cred.email || claims.email || `${id}@privaterelay.appleid.com`;
+        const givenName = cred.fullName?.givenName || undefined;
+        const familyName = cred.fullName?.familyName || undefined;
+        const nameParts = [givenName, familyName].filter(Boolean);
+        const name = nameParts.length > 0 ? nameParts.join(' ') : email.split('@')[0];
+        const priorUser = await this.tokenStore.getUser();
+        // Apple only returns full name and email on the very first sign in; preserve prior if present
+        const resolvedGivenName = givenName || priorUser?.givenName;
+        const resolvedFamilyName = familyName || priorUser?.familyName;
+        const resolvedName = name !== email.split('@')[0] ? name : priorUser?.name || name;
+        const user = {
+            id,
+            email: cred.email || priorUser?.email || email,
+            name: resolvedName,
+            givenName: resolvedGivenName,
+            familyName: resolvedFamilyName,
+            identityToken: cred.identityToken || undefined,
+            authorizationCode: cred.authorizationCode || undefined,
+        };
+        if (cred.identityToken) {
+            await this.tokenStore.setTokens({
+                idToken: cred.identityToken,
+                expiresAt: claims.exp ? claims.exp * 1000 : undefined,
+            });
+        }
+        await this.tokenStore.setUser(user);
+        this.notify(user);
+        return user;
+    }
+    async signOut() {
+        await this.tokenStore.removeTokens();
+        await this.tokenStore.setUser(null);
+        this.notify(null);
+    }
+    async isSignedIn() {
+        const tokens = await this.tokenStore.getTokens();
+        return validateTokens(tokens);
+    }
+    async getUser() {
+        if (this.currentUser)
+            return this.currentUser;
+        const cached = await this.tokenStore.getUser();
+        if (cached) {
+            this.currentUser = cached;
+            return cached;
+        }
+        return null;
+    }
+}
+exports.AppleAuthClient = AppleAuthClient;

package/dist/auth/github.d.ts

@@ -0,0 +1,72 @@
+export declare const GITHUB_AUTHORIZATION_ENDPOINT = "https://github.com/login/oauth/authorize";
+export declare const GITHUB_TOKEN_ENDPOINT = "https://github.com/login/oauth/access_token";
+export declare const GITHUB_API_ENDPOINT = "https://api.github.com";
+export declare const DEFAULT_GITHUB_AUTH_SCOPES: string[];
+export interface GitHubUser {
+    id: string;
+    login: string;
+    name: string;
+    email: string;
+    avatarUrl?: string;
+    bio?: string;
+    company?: string;
+    location?: string;
+}
+export interface GitHubAuthTokens {
+    accessToken: string;
+    tokenType?: string;
+    scope?: string;
+    expiresAt?: number;
+}
+export interface GitHubAuthTokenStore {
+    getTokens(): Promise<GitHubAuthTokens | null>;
+    setTokens(tokens: GitHubAuthTokens): Promise<void>;
+    removeTokens(): Promise<void>;
+    getUser(): Promise<GitHubUser | null>;
+    setUser(user: GitHubUser | null): Promise<void>;
+}
+export interface GitHubAuthKeyValueStorage {
+    getItem(key: string): Promise<unknown>;
+    setItem(key: string, value: unknown): Promise<void>;
+    removeItem(key: string): Promise<void>;
+}
+export interface GitHubAuthorizationRequest {
+    authorizationUrl: string;
+    redirectUri: string;
+    state: string;
+}
+export interface GitHubAuthorizationResponse {
+    code: string;
+    state: string;
+}
+export interface GitHubAuthClientOptions {
+    clientId: string;
+    clientSecret?: string;
+    tokenExchangeUrl?: string;
+    redirectUri: string;
+    scopes?: string[];
+    authorize: (request: GitHubAuthorizationRequest) => Promise<GitHubAuthorizationResponse | null>;
+    tokenStore?: GitHubAuthTokenStore;
+    storage?: GitHubAuthKeyValueStorage;
+    randomBytes?: (length: number) => Uint8Array;
+    fetch?: typeof fetch;
+    allowSignup?: boolean;
+}
+export declare function createInMemoryGitHubTokenStore(): GitHubAuthTokenStore;
+export declare function createGitHubAuthTokenStore(storage: GitHubAuthKeyValueStorage, prefix?: string): GitHubAuthTokenStore;
+export declare class GitHubAuthClient {
+    private readonly options;
+    private readonly tokenStore;
+    private readonly fetcher;
+    private readonly listeners;
+    private currentUser;
+    constructor(options: GitHubAuthClientOptions);
+    onAuthStateChange(listener: (user: GitHubUser | null) => void): () => void;
+    private notify;
+    signIn(): Promise<GitHubUser | null>;
+    signOut(): Promise<void>;
+    isSignedIn(): Promise<boolean>;
+    getUser(): Promise<GitHubUser | null>;
+    getValidAccessToken(): Promise<string>;
+    private fetchUserProfile;
+}

package/dist/auth/github.js

@@ -0,0 +1,284 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.GitHubAuthClient = exports.DEFAULT_GITHUB_AUTH_SCOPES = exports.GITHUB_API_ENDPOINT = exports.GITHUB_TOKEN_ENDPOINT = exports.GITHUB_AUTHORIZATION_ENDPOINT = void 0;
+exports.createInMemoryGitHubTokenStore = createInMemoryGitHubTokenStore;
+exports.createGitHubAuthTokenStore = createGitHubAuthTokenStore;
+exports.GITHUB_AUTHORIZATION_ENDPOINT = 'https://github.com/login/oauth/authorize';
+exports.GITHUB_TOKEN_ENDPOINT = 'https://github.com/login/oauth/access_token';
+exports.GITHUB_API_ENDPOINT = 'https://api.github.com';
+exports.DEFAULT_GITHUB_AUTH_SCOPES = ['read:user', 'user:email'];
+function secureRandomBytes(length) {
+    const crypto = globalThis.crypto;
+    if (!crypto?.getRandomValues) {
+        throw new Error('Secure random number generation is unavailable.');
+    }
+    return crypto.getRandomValues(new Uint8Array(length));
+}
+function base64UrlEncode(bytes) {
+    const alphabet = 'ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz0123456789-_';
+    let result = '';
+    for (let index = 0; index < bytes.length; index += 3) {
+        const first = bytes[index];
+        const second = bytes[index + 1];
+        const third = bytes[index + 2];
+        result += alphabet[first >> 2];
+        result += alphabet[((first & 3) << 4) | (second === undefined ? 0 : second >> 4)];
+        if (second !== undefined) {
+            result += alphabet[((second & 15) << 2) | (third === undefined ? 0 : third >> 6)];
+        }
+        if (third !== undefined)
+            result += alphabet[third & 63];
+    }
+    return result;
+}
+function validateTokens(value) {
+    if (!value || typeof value !== 'object')
+        return false;
+    const tokens = value;
+    return typeof tokens.accessToken === 'string';
+}
+function validateUser(value) {
+    if (!value || typeof value !== 'object')
+        return false;
+    const user = value;
+    return (typeof user.id === 'string' &&
+        typeof user.login === 'string' &&
+        typeof user.name === 'string');
+}
+function createInMemoryGitHubTokenStore() {
+    let storedTokens = null;
+    let storedUser = null;
+    return {
+        getTokens: async () => storedTokens,
+        setTokens: async (tokens) => {
+            storedTokens = tokens;
+        },
+        removeTokens: async () => {
+            storedTokens = null;
+        },
+        getUser: async () => storedUser,
+        setUser: async (user) => {
+            storedUser = user;
+        },
+    };
+}
+function createGitHubAuthTokenStore(storage, prefix = 'local-lite-github-auth') {
+    const tokensKey = `${prefix}-tokens`;
+    const userKey = `${prefix}-user`;
+    return {
+        getTokens: async () => {
+            const raw = await storage.getItem(tokensKey);
+            return validateTokens(raw) ? raw : null;
+        },
+        setTokens: tokens => storage.setItem(tokensKey, tokens),
+        removeTokens: () => storage.removeItem(tokensKey),
+        getUser: async () => {
+            const raw = await storage.getItem(userKey);
+            return validateUser(raw) ? raw : null;
+        },
+        setUser: async (user) => {
+            if (user) {
+                await storage.setItem(userKey, user);
+            }
+            else {
+                await storage.removeItem(userKey);
+            }
+        },
+    };
+}
+class GitHubAuthClient {
+    options;
+    tokenStore;
+    fetcher;
+    listeners = new Set();
+    currentUser = null;
+    constructor(options) {
+        this.options = options;
+        if (!options.clientId?.trim()) {
+            throw new Error('GitHub OAuth client ID is required.');
+        }
+        if (!options.redirectUri?.trim()) {
+            throw new Error('GitHub OAuth redirect URI is required.');
+        }
+        this.fetcher = options.fetch ?? fetch;
+        if (options.tokenStore) {
+            this.tokenStore = options.tokenStore;
+        }
+        else if (options.storage) {
+            this.tokenStore = createGitHubAuthTokenStore(options.storage);
+        }
+        else {
+            this.tokenStore = createInMemoryGitHubTokenStore();
+        }
+    }
+    onAuthStateChange(listener) {
+        this.listeners.add(listener);
+        return () => {
+            this.listeners.delete(listener);
+        };
+    }
+    notify(user) {
+        this.currentUser = user;
+        for (const listener of this.listeners) {
+            try {
+                listener(user);
+            }
+            catch (err) {
+                console.error('Error in GitHubAuthClient listener:', err);
+            }
+        }
+    }
+    async signIn() {
+        const randomBytes = this.options.randomBytes ?? secureRandomBytes;
+        const stateBytes = randomBytes(32);
+        if (stateBytes.length !== 32) {
+            throw new Error('The randomBytes provider returned an invalid number of bytes.');
+        }
+        const state = base64UrlEncode(stateBytes);
+        const scopes = this.options.scopes && this.options.scopes.length > 0
+            ? this.options.scopes
+            : exports.DEFAULT_GITHUB_AUTH_SCOPES;
+        const authorizationParams = new URLSearchParams({
+            client_id: this.options.clientId,
+            redirect_uri: this.options.redirectUri,
+            scope: scopes.join(' '),
+            state,
+            allow_signup: String(this.options.allowSignup ?? true),
+        });
+        const authorization = await this.options.authorize({
+            authorizationUrl: `${exports.GITHUB_AUTHORIZATION_ENDPOINT}?${authorizationParams.toString()}`,
+            redirectUri: this.options.redirectUri,
+            state,
+        });
+        if (!authorization) {
+            return null;
+        }
+        if (authorization.state !== state) {
+            throw new Error('GitHub OAuth state validation failed. Please try connecting again.');
+        }
+        if (!authorization.code) {
+            throw new Error('GitHub OAuth did not return an authorization code.');
+        }
+        const tokenEndpoint = this.options.tokenExchangeUrl || exports.GITHUB_TOKEN_ENDPOINT;
+        const requestPayload = {
+            client_id: this.options.clientId,
+            code: authorization.code,
+            redirect_uri: this.options.redirectUri,
+            state,
+        };
+        if (this.options.clientSecret) {
+            requestPayload.client_secret = this.options.clientSecret;
+        }
+        const response = await this.fetcher(tokenEndpoint, {
+            method: 'POST',
+            headers: {
+                'Content-Type': 'application/json',
+                Accept: 'application/json',
+            },
+            body: JSON.stringify(requestPayload),
+        });
+        const payload = (await response.json());
+        if (!response.ok || payload.error) {
+            throw new Error(payload.error_description || payload.error || `GitHub OAuth token exchange failed (${response.status}).`);
+        }
+        if (!payload.access_token) {
+            throw new Error('GitHub OAuth did not return an access token.');
+        }
+        const storedTokens = {
+            accessToken: payload.access_token,
+            tokenType: payload.token_type,
+            scope: payload.scope,
+            expiresAt: payload.expires_in ? Date.now() + payload.expires_in * 1000 : undefined,
+        };
+        await this.tokenStore.setTokens(storedTokens);
+        const user = await this.fetchUserProfile(storedTokens.accessToken);
+        await this.tokenStore.setUser(user);
+        this.notify(user);
+        return user;
+    }
+    async signOut() {
+        await this.tokenStore.removeTokens();
+        await this.tokenStore.setUser(null);
+        this.notify(null);
+    }
+    async isSignedIn() {
+        const tokens = await this.tokenStore.getTokens();
+        return validateTokens(tokens);
+    }
+    async getUser() {
+        if (this.currentUser) {
+            return this.currentUser;
+        }
+        const cached = await this.tokenStore.getUser();
+        if (cached) {
+            this.currentUser = cached;
+            return cached;
+        }
+        const tokens = await this.tokenStore.getTokens();
+        if (!validateTokens(tokens)) {
+            return null;
+        }
+        try {
+            const user = await this.fetchUserProfile(tokens.accessToken);
+            await this.tokenStore.setUser(user);
+            this.currentUser = user;
+            return user;
+        }
+        catch {
+            return null;
+        }
+    }
+    async getValidAccessToken() {
+        const tokens = await this.tokenStore.getTokens();
+        if (!validateTokens(tokens)) {
+            throw new Error('No GitHub account signed in. Please sign in first.');
+        }
+        return tokens.accessToken;
+    }
+    async fetchUserProfile(accessToken) {
+        const res = await this.fetcher(`${exports.GITHUB_API_ENDPOINT}/user`, {
+            headers: {
+                Authorization: `Bearer ${accessToken}`,
+                Accept: 'application/vnd.github.v3+json',
+                'User-Agent': 'local-lite-auth',
+            },
+        });
+        if (!res.ok) {
+            throw new Error(`Failed to fetch GitHub user profile (${res.status}).`);
+        }
+        const raw = (await res.json());
+        let email = raw.email;
+        // If email is private on profile, fetch from /user/emails endpoint
+        if (!email) {
+            try {
+                const emailsRes = await this.fetcher(`${exports.GITHUB_API_ENDPOINT}/user/emails`, {
+                    headers: {
+                        Authorization: `Bearer ${accessToken}`,
+                        Accept: 'application/vnd.github.v3+json',
+                        'User-Agent': 'local-lite-auth',
+                    },
+                });
+                if (emailsRes.ok) {
+                    const emails = (await emailsRes.json());
+                    const primary = emails.find(e => e.primary && e.verified) || emails[0];
+                    if (primary)
+                        email = primary.email;
+                }
+            }
+            catch {
+                // Fallback to username generated placeholder if emails restricted
+            }
+        }
+        return {
+            id: String(raw.id),
+            login: raw.login,
+            name: raw.name || raw.login,
+            email: email || `${raw.login}@users.noreply.github.com`,
+            avatarUrl: raw.avatar_url,
+            bio: raw.bio,
+            company: raw.company,
+            location: raw.location,
+        };
+    }
+}
+exports.GitHubAuthClient = GitHubAuthClient;

package/dist/auth/index.d.ts

@@ -1 +1,4 @@
 export * from './google.js';
+export * from './microsoft.js';
+export * from './github.js';
+export * from './apple.js';

package/dist/auth/index.js

@@ -15,3 +15,6 @@ var __exportStar = (this && this.__exportStar) || function(m, exports) {
 };
 Object.defineProperty(exports, "__esModule", { value: true });
 __exportStar(require("./google.js"), exports);
+__exportStar(require("./microsoft.js"), exports);
+__exportStar(require("./github.js"), exports);
+__exportStar(require("./apple.js"), exports);