@aerogel/plugin-solid 0.0.1-next.129b164cda8e791661ba16ad7bf51aaeae6be2eb

package/src/errors/index.ts

@@ -0,0 +1,3 @@
+export { default as AuthenticationCancelledError } from '@/errors/AuthenticationCancelledError';
+export { default as AuthenticationFailedError } from '@/errors/AuthenticationFailedError';
+export { default as ContainerAlreadyInUse } from '@/errors/ContainerAlreadyInUse';

package/src/forms/validation.ts

@@ -0,0 +1,11 @@
+import { defineFormValidationRule } from '@aerogel/core';
+
+export function defineFormValidationRules(): void {
+    defineFormValidationRule<string>('container_url', (value) => {
+        if (value.endsWith('/')) {
+            return;
+        }
+
+        return 'containerEndingSlashMissing';
+    });
+}

package/src/main.ts

@@ -0,0 +1,70 @@
+import { Events, bootServices, registerErrorHandler } from '@aerogel/core';
+import { bootSolidModels } from 'soukai-solid';
+import type { Plugin } from '@aerogel/core';
+import type { SolidStore, SolidUserProfile } from '@noeldemartin/solid-utils';
+
+import Solid from '@/services/Solid';
+import { DEFAULT_STATE } from '@/services/Solid.state';
+import { defineFormValidationRules } from '@/forms/validation';
+import {
+    authenticators as baseAuthenticators,
+    getAuthenticator,
+    registerAuthenticators,
+    setDefaultAuthenticator,
+} from '@/auth';
+import { AuthenticationFailedError } from '@/errors';
+import type Authenticator from '@/auth/Authenticator';
+import type { AuthenticatorName } from '@/auth';
+
+const services = { $solid: Solid };
+
+export * from './auth';
+export * from './components';
+export * from './errors';
+export * from './services/Solid';
+export { Solid };
+
+export interface Options {
+    autoReconnect?: boolean;
+    authenticators?: Record<string, Authenticator>;
+    defaultAuthenticator?: AuthenticatorName;
+    onUserProfileLoaded?(user: SolidUserProfile, store: SolidStore): Promise<unknown> | unknown;
+}
+
+export type SolidServices = typeof services;
+
+export default function solid(options: Options = {}): Plugin {
+    return {
+        async install(app) {
+            bootSolidModels();
+            registerAuthenticators({ ...baseAuthenticators, ...(options.authenticators ?? {}) });
+            defineFormValidationRules();
+            setDefaultAuthenticator(getAuthenticator(options.defaultAuthenticator ?? 'inrupt'));
+            registerErrorHandler((error) => {
+                if (!(error instanceof AuthenticationFailedError)) {
+                    return;
+                }
+
+                return error.description ? `${error.message} (${error.description})` : error.message;
+            });
+
+            if (typeof options.autoReconnect === 'boolean') {
+                DEFAULT_STATE.autoReconnect = options.autoReconnect;
+
+                Solid.hasPersistedState() || (Solid.autoReconnect = options.autoReconnect);
+            }
+
+            if (options.onUserProfileLoaded) {
+                Events.on('solid:user-profile-loaded', ([user, store]) => {
+                    options.onUserProfileLoaded?.(user, store);
+                });
+            }
+
+            await bootServices(app, services);
+        },
+    };
+}
+
+declare module '@aerogel/core' {
+    interface Services extends SolidServices {}
+}

package/src/services/Solid.state.ts

@@ -0,0 +1,56 @@
+import { defineServiceState } from '@aerogel/core';
+import type { ErrorSource } from '@aerogel/core';
+import type { Fetch, SolidUserProfile } from '@noeldemartin/solid-utils';
+
+import type { AuthSession } from '@/auth/Authenticator';
+import type { AuthenticatorName } from '@/auth';
+
+export const DEFAULT_STATE = { autoReconnect: true };
+
+export default defineServiceState({
+    name: 'solid',
+    persist: ['autoReconnect', 'dismissed', 'previousSession', 'profiles', 'staleProfiles'],
+    initialState: {
+        autoReconnect: DEFAULT_STATE.autoReconnect,
+        dismissed: false,
+        ignorePreviousSessionError: false,
+        loginStartupError: null as ErrorSource | null,
+        loginOngoing: false,
+        preferredAuthenticator: null as AuthenticatorName | null,
+        previousSession: null as {
+            profile?: SolidUserProfile;
+            authenticator: AuthenticatorName;
+            loginUrl: string;
+            error: ErrorSource | null;
+        } | null,
+        profiles: {} as Record<string, SolidUserProfile>,
+        session: null as AuthSession | null,
+        loginStale: false,
+        staleProfiles: [] as string[],
+    },
+    serialize(state) {
+        if (state.previousSession?.error instanceof Error) {
+            state.previousSession.error = state.previousSession.error.message;
+        }
+
+        return state;
+    },
+    computed: {
+        user: (state) => state.session?.user ?? state.previousSession?.profile ?? null,
+        authenticator: (state) => state.session?.authenticator ?? null,
+        fetch(): Fetch {
+            return this.authenticator?.getAuthenticatedFetch() ?? globalThis.fetch.bind(globalThis);
+        },
+        error(state): ErrorSource | null {
+            if (state.loginStartupError) {
+                return state.loginStartupError ?? null;
+            }
+
+            if (state.ignorePreviousSessionError) {
+                return null;
+            }
+
+            return state.previousSession?.error ?? null;
+        },
+    },
+});

package/src/services/Solid.ts

@@ -0,0 +1,529 @@
+import {
+    after,
+    arrayFilter,
+    arrayUnique,
+    arrayWithout,
+    asyncMemo,
+    facade,
+    fail,
+    getLocationQueryParameter,
+    hasLocationQueryParameter,
+    objectWithout,
+    objectWithoutEmpty,
+    parseBoolean,
+    requireUrlParse,
+    setAsyncMemo,
+    tap,
+    urlRoot,
+} from '@noeldemartin/utils';
+import { App, Colors, Errors, Events, UI, translateWithDefault } from '@aerogel/core';
+import { fetchLoginUserProfile } from '@noeldemartin/solid-utils';
+import { setEngine } from 'soukai';
+import { SolidACLAuthorization, SolidContainer, SolidDocument, SolidTypeIndex } from 'soukai-solid';
+import type { ErrorSource } from '@aerogel/core';
+import type { Fetch, SolidModelConstructor } from 'soukai-solid';
+import type { SolidStore, SolidUserProfile } from '@noeldemartin/solid-utils';
+
+import AuthenticationCancelledError from '@/errors/AuthenticationCancelledError';
+import { ContainerAlreadyInUse } from '@/errors';
+import { getAuthenticator } from '@/auth';
+import type Authenticator from '@/auth/Authenticator';
+import type { AuthenticatorName } from '@/auth';
+import type { AuthSession } from '@/auth/Authenticator';
+
+import Service, { DEFAULT_STATE } from './Solid.state';
+
+export type LoginOptions = {
+    authenticator?: AuthenticatorName;
+    onError?(error: ErrorSource): unknown;
+    fallbackUrl?: string;
+    loading?: boolean;
+};
+
+export type ReconnectOptions = Omit<LoginOptions, 'authenticator'> & {
+    force?: boolean;
+};
+
+export class SolidService extends Service {
+
+    public isLoggedIn(): this is { session: AuthSession; user: SolidUserProfile; authenticator: Authenticator } {
+        return !!this.session;
+    }
+
+    public wasLoggedIn(): this is { user: SolidUserProfile } {
+        return !!this.previousSession;
+    }
+
+    public hasLoggedIn(): this is { user: SolidUserProfile } {
+        return !!(this.session || this.previousSession);
+    }
+
+    public requireAuthenticator(): Authenticator {
+        return this.authenticator ?? fail('Could not get authenticator');
+    }
+
+    public requireUser(): SolidUserProfile {
+        return this.user ?? fail('Could not get user profile (are you logged in?)');
+    }
+
+    public requireUserProfile(url: string): Promise<SolidUserProfile> {
+        return this.getUserProfile(url, true);
+    }
+
+    public async getUserProfile(url: string, required: true): Promise<SolidUserProfile>;
+    public async getUserProfile(url: string, required?: false): Promise<SolidUserProfile | null>;
+    public async getUserProfile(url: string, required: boolean = false): Promise<SolidUserProfile | null> {
+        let profileStore: SolidStore | null = null;
+        const usingAuthenticatedFetch = !!this.authenticator?.getAuthenticatedFetch();
+
+        return (
+            this.profiles[url] ??
+            tap(
+                await fetchLoginUserProfile(url, {
+                    fetch: this.fetch,
+                    required,
+                    onLoaded(store) {
+                        profileStore = store;
+                    },
+                }),
+                async (profile) => {
+                    if (!profile) {
+                        return;
+                    }
+
+                    if (profileStore) {
+                        await Events.emit('solid:user-profile-loaded', [profile, profileStore]);
+                    }
+
+                    this.rememberProfile(profile);
+
+                    if (!usingAuthenticatedFetch) {
+                        this.setState({ staleProfiles: arrayUnique(this.staleProfiles.concat([profile.webId])) });
+                    }
+                },
+            )
+        );
+    }
+
+    public async refreshUserProfile(): Promise<void> {
+        if (!this.isLoggedIn()) {
+            return;
+        }
+
+        this.setState({ profiles: objectWithout(this.profiles, [this.user.webId]) });
+
+        const user = await this.requireUserProfile(this.user.webId);
+
+        this.setState({
+            session: {
+                ...this.session,
+                user,
+            },
+        });
+    }
+
+    public async login(loginUrl: string, options: LoginOptions = {}): Promise<boolean> {
+        if (App.development && loginUrl === 'dev') {
+            loginUrl = 'http://localhost:3000';
+        }
+
+        if (!/^https?:\/\//.test(loginUrl)) {
+            options.fallbackUrl ??= `http://${loginUrl}`;
+            loginUrl = `https://${loginUrl}`;
+        }
+
+        if (this.isLoggedIn()) {
+            return true;
+        }
+
+        if (this.loginOngoing) {
+            throw new Error('Authentication already in progress');
+        }
+
+        if (!options.loading) {
+            return this.attemptLogin(loginUrl, options);
+        }
+
+        return UI.loading(translateWithDefault('solid.loggingIn', 'Logging in...'), () => {
+            return this.attemptLogin(loginUrl, options);
+        });
+    }
+
+    public async reconnect(options: ReconnectOptions = {}): Promise<void> {
+        const { force, ...loginOptions } = options;
+        if (this.isLoggedIn() || !this.previousSession || (this.previousSession.error !== null && !force)) {
+            return;
+        }
+
+        await this.login(this.previousSession.loginUrl, {
+            authenticator: this.previousSession.authenticator,
+            ...loginOptions,
+            loading: loginOptions.loading ?? false,
+        });
+    }
+
+    public async logout(force: boolean = false): Promise<void> {
+        const isCloudReady = !App.plugin('@aerogel/offline-first') || !!App.service('$cloud')?.ready;
+        const hasLocalChanges = !App.plugin('@aerogel/offline-first') || !!App.service('$cloud')?.dirty;
+        const [confirmLogout, options] = force
+            ? [true, { wipeLocalData: isCloudReady }]
+            : await UI.confirm(
+                isCloudReady
+                    ? translateWithDefault('solid.logoutConfirmTitle', 'Log out from this device?')
+                    : translateWithDefault('solid.disconnectConfirmTitle', 'Disconnect account?'),
+                isCloudReady
+                    ? hasLocalChanges
+                        ? translateWithDefault(
+                            'solid.logoutConfirmMessageWithLocalChanges',
+                            'There are some changes that haven\'t been synchronized and will be lost, ' +
+                                    'but the rest of the data will remain in your Solid POD.',
+                        )
+                        : translateWithDefault(
+                            'solid.logoutConfirmMessage',
+                            'Logging out will remove all the data from this device, ' +
+                                    'but you\'ll still have it in your Solid POD.',
+                        )
+                    : translateWithDefault(
+                        'solid.disconnectConfirmMessage',
+                        'You\'ll need to introduce logging details again to connect to your Solid POD.',
+                    ),
+                {
+                    acceptText: translateWithDefault('solid.logoutConfirmAccept', 'Log out'),
+                    acceptColor: Colors.Danger,
+                    cancelText: translateWithDefault(
+                        'solid.logoutConfirmCancel',
+                        translateWithDefault('ui.cancel', 'Cancel'),
+                    ),
+                    checkboxes: isCloudReady
+                        ? hasLocalChanges
+                            ? {
+                                wipeLocalData: {
+                                    label: translateWithDefault(
+                                        'solid.logoutConfirmWipeNotice',
+                                        'I understand that changes that haven\'t been synchronized will be lost.',
+                                    ),
+                                    default: false,
+                                    required: true,
+                                },
+                            }
+                            : undefined
+                        : {
+                            wipeLocalData: {
+                                label: translateWithDefault(
+                                    'solid.logoutConfirmWipe',
+                                    'Also remove all existing data (tasks, lists, etc.)',
+                                ),
+                                default: false,
+                            },
+                        },
+                },
+            );
+
+        if (!confirmLogout) {
+            return;
+        }
+
+        if (!this.previousSession) {
+            return;
+        }
+
+        await UI.loading(translateWithDefault('solid.logoutOngoing', 'Logging out...'), async () => {
+            this.setState({
+                dismissed: false,
+                ignorePreviousSessionError: false,
+                loginStartupError: null,
+                previousSession: null,
+                ...DEFAULT_STATE,
+            });
+
+            this.isLoggedIn() && (await this.authenticator.logout());
+
+            await Events.emit('auth:logout', { wipeLocalData: options.wipeLocalData ?? true });
+            await Events.emit('auth:after-logout');
+        });
+    }
+
+    public async whenLoggedIn<T>(callback: (session: AuthSession) => T): Promise<T> {
+        if (this.isLoggedIn()) {
+            return callback(this.session);
+        }
+
+        return new Promise((resolve) => {
+            const onLogin = (session: AuthSession) => resolve(callback(session));
+
+            Events.once('auth:login', onLogin);
+        });
+    }
+
+    public dismiss(): void {
+        this.setState({ dismissed: true });
+    }
+
+    public async findOrCreatePrivateTypeIndex(): Promise<SolidTypeIndex> {
+        return (await this.findPrivateTypeIndex()) ?? (await this.createPrivateTypeIndex());
+    }
+
+    public async findPrivateTypeIndex(): Promise<SolidTypeIndex | null> {
+        const { webId, privateTypeIndexUrl } = this.requireUser();
+        const engine = this.requireAuthenticator().engine;
+
+        if (!privateTypeIndexUrl) {
+            return null;
+        }
+
+        return asyncMemo(`${webId}-privateTypeIndex`, () =>
+            SolidTypeIndex.withEngine(engine).find(privateTypeIndexUrl));
+    }
+
+    public async findOrCreatePublicTypeIndex(): Promise<SolidTypeIndex> {
+        return (await this.findPublicTypeIndex()) ?? (await this.createPublicTypeIndex());
+    }
+
+    public async findPublicTypeIndex(): Promise<SolidTypeIndex | null> {
+        const { webId, publicTypeIndexUrl } = this.requireUser();
+        const engine = this.requireAuthenticator().engine;
+
+        if (!publicTypeIndexUrl) {
+            return null;
+        }
+
+        return asyncMemo(`${webId}-publicTypeIndex`, () => SolidTypeIndex.withEngine(engine).find(publicTypeIndexUrl));
+    }
+
+    public async createPrivateContainer(options: {
+        url: string;
+        name?: string;
+        registerFor?: SolidModelConstructor;
+        reuseExisting?: boolean;
+    }): Promise<SolidContainer> {
+        const engine = this.requireAuthenticator().engine;
+
+        return SolidContainer.withEngine(engine, async () => {
+            const existingContainer = await SolidContainer.find(options.url);
+
+            if (existingContainer && !options.reuseExisting) {
+                throw new ContainerAlreadyInUse(existingContainer);
+            }
+
+            const container = existingContainer ?? new SolidContainer({ url: options.url, name: options.name });
+
+            await container.save();
+
+            if (options.registerFor) {
+                const typeIndex = await this.findOrCreatePrivateTypeIndex();
+
+                await container.register(typeIndex, options.registerFor);
+            }
+
+            return container;
+        });
+    }
+
+    protected async boot(): Promise<void> {
+        await Errors.booted;
+
+        if (hasLocationQueryParameter('authenticator')) {
+            this.setState({
+                preferredAuthenticator: getLocationQueryParameter('authenticator') as AuthenticatorName,
+            });
+        }
+
+        if (hasLocationQueryParameter('refreshProfile')) {
+            this.setState({
+                staleProfiles: arrayUnique(
+                    this.staleProfiles.concat(arrayFilter([this.session?.user.webId, this.previousSession?.loginUrl])),
+                ),
+            });
+        }
+
+        await this.restorePreviousSession();
+        await this.startupReconnect();
+    }
+
+    protected async createPrivateTypeIndex(): Promise<SolidTypeIndex> {
+        const user = this.requireUser();
+        const authenticator = this.requireAuthenticator();
+        const typeIndex = await SolidTypeIndex.withEngine(authenticator.engine).createPrivate(user);
+
+        return tap(typeIndex, () => {
+            user.privateTypeIndexUrl = typeIndex.url;
+
+            setAsyncMemo(`${user.webId}-privateTypeIndex`, typeIndex);
+
+            this.rememberProfile(user);
+        });
+    }
+
+    public async createPublicTypeIndex(): Promise<SolidTypeIndex> {
+        const user = this.requireUser();
+        const authenticator = this.requireAuthenticator();
+        const typeIndex = await SolidTypeIndex.withEngine(authenticator.engine).createPublic(user);
+
+        return tap(typeIndex, () => {
+            user.privateTypeIndexUrl = typeIndex.url;
+
+            setAsyncMemo(`${user.webId}-publicTypeIndex`, typeIndex);
+
+            this.rememberProfile(user);
+        });
+    }
+
+    protected async attemptLogin(loginUrl: string, options: LoginOptions): Promise<boolean> {
+        const authenticatorName = options.authenticator ?? this.preferredAuthenticator ?? 'default';
+        const handleLoginError =
+            options.onError ??
+            ((error: ErrorSource) =>
+                App.isMounted() ? Errors.report(error) : this.setState({ loginStartupError: error }));
+        const staleTimeout = setTimeout(() => (this.loginStale = true), 10000);
+        const initialState = {
+            dismissed: this.dismissed,
+            ignorePreviousSessionError: this.ignorePreviousSessionError,
+            previousSession: this.previousSession,
+        };
+        this.loginOngoing = true;
+
+        try {
+            const profile = await this.getUserProfile(loginUrl);
+            const oidcIssuerUrl = profile?.oidcIssuerUrl ?? urlRoot(profile?.webId ?? loginUrl);
+            const authenticator = await this.bootAuthenticator(authenticatorName);
+            const { domain: loginDomain } = requireUrlParse(loginUrl);
+
+            this.setState({
+                dismissed: false,
+                ignorePreviousSessionError: true,
+                previousSession: objectWithoutEmpty({
+                    profile,
+                    loginUrl,
+                    authenticator: authenticatorName,
+                    error: translateWithDefault(
+                        'auth.stuckConnecting',
+                        `We didn't hear back from the identity provider at \`${loginDomain}\`, maybe try reconnecting?`,
+                    ),
+                }),
+            });
+
+            await Events.emit('auth:before-login');
+
+            // This should redirect away from the app, so in most cases
+            // the rest of the code won't be reached.
+            await authenticator.login(oidcIssuerUrl, profile);
+
+            return true;
+        } catch (error) {
+            this.setState(initialState);
+
+            if (error instanceof AuthenticationCancelledError) {
+                return false;
+            }
+
+            if (options.fallbackUrl) {
+                return after().then(() => this.login(options.fallbackUrl ?? '', objectWithout(options, 'fallbackUrl')));
+            }
+
+            handleLoginError(error);
+
+            return false;
+        } finally {
+            clearTimeout(staleTimeout);
+
+            this.setState({
+                loginOngoing: false,
+                loginStale: false,
+            });
+        }
+    }
+
+    private async restorePreviousSession(): Promise<void> {
+        if (!this.previousSession) {
+            return;
+        }
+
+        await this.bootAuthenticator(this.previousSession.authenticator);
+    }
+
+    private async startupReconnect(): Promise<void> {
+        if (!this.reconnectOnStartup()) {
+            return;
+        }
+
+        await this.reconnect();
+    }
+
+    private reconnectOnStartup(): boolean {
+        if (hasLocationQueryParameter('autoReconnect')) {
+            return parseBoolean(getLocationQueryParameter('autoReconnect'));
+        }
+
+        return this.autoReconnect;
+    }
+
+    private async bootAuthenticator(name: AuthenticatorName): Promise<Authenticator> {
+        const authenticator = getAuthenticator(name);
+
+        authenticator.addListener({
+            onSessionStarted: async (session) => {
+                this.setState({
+                    session,
+                    previousSession: {
+                        authenticator: authenticator.name,
+                        loginUrl: session.loginUrl,
+                        profile: session.user,
+                        error: null,
+                    },
+                });
+
+                if (this.staleProfiles.includes(session.user.webId)) {
+                    await this.refreshUserProfile();
+                }
+
+                App.plugin('@aerogel/offline-first') || setEngine(session.authenticator.engine);
+
+                SolidACLAuthorization.setEngine(session.authenticator.engine);
+                SolidTypeIndex.setEngine(session.authenticator.engine);
+                SolidDocument.setEngine(session.authenticator.engine);
+
+                await Events.emit('auth:login', session);
+            },
+            onSessionFailed: async (loginUrl, error) => {
+                this.setState({
+                    session: null,
+                    previousSession: {
+                        authenticator: authenticator.name,
+                        loginUrl,
+                        error,
+                    },
+                });
+            },
+            onSessionEnded: () => this.setState({ session: null }),
+            onAuthenticatedFetchReady: (fetch) => Events.emit('auth:fetch-ready', fetch),
+        });
+
+        await authenticator.boot();
+
+        return authenticator;
+    }
+
+    private rememberProfile(profile: SolidUserProfile): void {
+        this.setState({
+            profiles: {
+                ...this.profiles,
+                [profile.webId]: profile,
+            },
+            staleProfiles: arrayWithout(this.staleProfiles, profile.webId),
+        });
+    }
+
+}
+
+export default facade(SolidService);
+
+declare module '@aerogel/core' {
+    export interface EventsPayload {
+        'auth:fetch-ready': Fetch;
+        'auth:before-login': void;
+        'auth:login': AuthSession;
+        'auth:logout': { wipeLocalData: boolean };
+        'auth:after-logout': void;
+        'solid:user-profile-loaded': [SolidUserProfile, SolidStore];
+    }
+}

package/src/types/env.d.ts

@@ -0,0 +1 @@
+/// <reference types="@aerogel/plugin-offline-first" />

package/src/types/shims.d.ts

@@ -0,0 +1,7 @@
+declare module '*.vue' {
+    import type { ComponentOptions } from 'vue';
+
+    const component: ComponentOptions;
+
+    export default component;
+}

package/tsconfig.json

@@ -0,0 +1,11 @@
+{
+    "extends": "../../tsconfig.json",
+    "compilerOptions": {
+        "baseUrl": ".",
+        "types": ["unplugin-icons/types/vue3", "@aerogel/vite/dist/virtual"],
+        "paths": {
+            "@/*": ["./src/*"]
+        }
+    },
+    "include": ["src/**/*.ts", "src/**/*.vue"]
+}