@gaballahtech/seba 0.2.1 → 0.5.0

package/dist/pod.js

@@ -0,0 +1,264 @@
+/**
+ * Tiny, dependency-free helpers for the Turtle subset used by Solid pods.
+ *
+ * Supported syntax: `.`-terminated triples with `<iri>`, `_:blank`, and literal
+ * terms (`"value"`, `"value"@lang`, `"value"^^<datatype>`), plus bare integers,
+ * decimals and booleans. `@prefix`/`PREFIX`/`BASE` lines are ignored; prefix
+ * expansion is not performed, so terms must already be absolute.
+ */
+const XSD = "http://www.w3.org/2001/XMLSchema#";
+/**
+ * Parse a small Turtle document into triples.
+ *
+ * @throws Error when a statement does not contain exactly three supported terms.
+ */
+export function parseSubjectTriples(input) {
+    const tokens = tokenize(input);
+    const triples = [];
+    let statement = [];
+    for (const token of tokens) {
+        if (token === ".") {
+            if (statement.length === 0) {
+                continue;
+            }
+            if (statement.length !== 3) {
+                throw new Error(`Unsupported Turtle statement: expected 3 terms, found ${String(statement.length)}.`);
+            }
+            triples.push({
+                subject: parseTerm(statement[0]),
+                predicate: parseTerm(statement[1]),
+                object: parseTerm(statement[2]),
+            });
+            statement = [];
+            continue;
+        }
+        statement.push(token);
+    }
+    if (statement.length > 0) {
+        throw new Error("Unsupported Turtle: the final statement is not terminated by '.'.");
+    }
+    return triples;
+}
+/** Turn triples into a nested `{ [subject]: { [predicate]: value } }` object. */
+export function objectify(triples) {
+    const document = {};
+    for (const { subject, predicate, object } of triples) {
+        const bucket = (document[subject.value] ??= {});
+        const value = toValue(object);
+        const existing = bucket[predicate.value];
+        if (existing === undefined) {
+            bucket[predicate.value] = value;
+        }
+        else if (Array.isArray(existing)) {
+            existing.push(value);
+        }
+        else {
+            bucket[predicate.value] = [existing, value];
+        }
+    }
+    return document;
+}
+/** Serialize triples to Turtle, one statement per line. */
+export function toTurtle(triples) {
+    return triples
+        .map(({ subject, predicate, object }) => `${formatTerm(subject)} ${formatTerm(predicate)} ${formatTerm(object)} .`)
+        .join("\n");
+}
+/** The three helpers, also exposed as `Seba.pod`. */
+export const pod = { parseSubjectTriples, objectify, toTurtle };
+function tokenize(input) {
+    const tokens = [];
+    let index = 0;
+    while (index < input.length) {
+        const character = input[index];
+        if (/\s/.test(character)) {
+            index += 1;
+            continue;
+        }
+        if (character === "#") {
+            while (index < input.length && input[index] !== "\n") {
+                index += 1;
+            }
+            continue;
+        }
+        if (isDirectiveStart(input, index)) {
+            while (index < input.length && input[index] !== "\n") {
+                index += 1;
+            }
+            continue;
+        }
+        if (character === "<") {
+            const end = input.indexOf(">", index);
+            if (end < 0) {
+                throw new Error("Unsupported Turtle: unterminated IRI.");
+            }
+            tokens.push(input.slice(index, end + 1));
+            index = end + 1;
+            continue;
+        }
+        if (character === '"') {
+            let cursor = index + 1;
+            let token = '"';
+            while (cursor < input.length) {
+                const current = input[cursor];
+                token += current;
+                cursor += 1;
+                if (current === "\\") {
+                    token += input[cursor] ?? "";
+                    cursor += 1;
+                    continue;
+                }
+                if (current === '"') {
+                    break;
+                }
+            }
+            while (cursor < input.length) {
+                if (input[cursor] === "@") {
+                    let end = cursor + 1;
+                    while (end < input.length && /[A-Za-z0-9-]/.test(input[end])) {
+                        end += 1;
+                    }
+                    token += input.slice(cursor, end);
+                    cursor = end;
+                    continue;
+                }
+                if (input.startsWith("^^", cursor)) {
+                    const iriStart = input.indexOf("<", cursor);
+                    const iriEnd = iriStart < 0 ? -1 : input.indexOf(">", iriStart);
+                    if (iriStart < 0 || iriEnd < 0) {
+                        throw new Error("Unsupported Turtle: malformed datatype suffix.");
+                    }
+                    token += input.slice(cursor, iriEnd + 1);
+                    cursor = iriEnd + 1;
+                    continue;
+                }
+                break;
+            }
+            tokens.push(token);
+            index = cursor;
+            continue;
+        }
+        if (character === "." && isStatementEnd(input, index)) {
+            tokens.push(".");
+            index += 1;
+            continue;
+        }
+        let end = index;
+        while (end < input.length && !/[\s]/.test(input[end])) {
+            if (input[end] === "." && isStatementEnd(input, end)) {
+                break;
+            }
+            end += 1;
+        }
+        tokens.push(input.slice(index, end));
+        index = end;
+    }
+    return tokens;
+}
+function isStatementEnd(input, index) {
+    const next = input[index + 1];
+    return next === undefined || /\s/.test(next);
+}
+function isDirectiveStart(input, index) {
+    const lineStart = /(?:^|\n)[ \t]*$/.test(input.slice(0, index));
+    if (!lineStart) {
+        return false;
+    }
+    return /^(@prefix|@base|PREFIX\b|BASE\b)/i.test(input.slice(index));
+}
+function parseTerm(token) {
+    if (token.startsWith("<") && token.endsWith(">")) {
+        return { termType: "NamedNode", value: token.slice(1, -1) };
+    }
+    if (token.startsWith("_:")) {
+        return { termType: "BlankNode", value: token.slice(2) };
+    }
+    if (token.startsWith('"')) {
+        const end = closingQuoteIndex(token);
+        const literal = { termType: "Literal", value: unescapeLiteral(token.slice(1, end)) };
+        const suffix = token.slice(end + 1);
+        if (suffix.startsWith("@")) {
+            literal.language = suffix.slice(1);
+        }
+        else if (suffix.startsWith("^^")) {
+            const datatype = suffix.slice(2);
+            literal.datatype = datatype.startsWith("<") ? datatype.slice(1, -1) : datatype;
+        }
+        return literal;
+    }
+    if (token === "true" || token === "false") {
+        return { termType: "Literal", value: token, datatype: `${XSD}boolean` };
+    }
+    if (/^[+-]?\d+$/.test(token)) {
+        return { termType: "Literal", value: token, datatype: `${XSD}integer` };
+    }
+    if (/^[+-]?(?:\d+\.\d*|\.\d+)$/.test(token)) {
+        return { termType: "Literal", value: token, datatype: `${XSD}decimal` };
+    }
+    throw new Error(`Unsupported Turtle term: ${token}`);
+}
+function closingQuoteIndex(token) {
+    for (let index = 1; index < token.length; index += 1) {
+        if (token[index] === "\\") {
+            index += 1;
+            continue;
+        }
+        if (token[index] === '"') {
+            return index;
+        }
+    }
+    throw new Error("Unsupported Turtle: unterminated literal.");
+}
+function unescapeLiteral(value) {
+    return value
+        .replace(/\\n/g, "\n")
+        .replace(/\\r/g, "\r")
+        .replace(/\\t/g, "\t")
+        .replace(/\\"/g, '"')
+        .replace(/\\\\/g, "\\");
+}
+function toValue(term) {
+    if (term.termType !== "Literal") {
+        return { id: term.value };
+    }
+    switch (term.datatype) {
+        case `${XSD}boolean`:
+            return term.value === "true";
+        case `${XSD}integer`:
+        case `${XSD}decimal`:
+        case `${XSD}double`: {
+            const numeric = Number(term.value);
+            return Number.isFinite(numeric) ? numeric : term.value;
+        }
+        default:
+            return term.value;
+    }
+}
+function formatTerm(term) {
+    if (term.termType === "NamedNode") {
+        return `<${term.value}>`;
+    }
+    if (term.termType === "BlankNode") {
+        return `_:${term.value.replace(/^_:/, "")}`;
+    }
+    if (term.datatype === `${XSD}integer` ||
+        term.datatype === `${XSD}decimal` ||
+        term.datatype === `${XSD}double` ||
+        term.datatype === `${XSD}boolean`) {
+        return term.value;
+    }
+    const escaped = term.value
+        .replace(/\\/g, "\\\\")
+        .replace(/"/g, '\\"')
+        .replace(/\n/g, "\\n")
+        .replace(/\r/g, "\\r")
+        .replace(/\t/g, "\\t");
+    if (term.language !== undefined) {
+        return `"${escaped}"@${term.language}`;
+    }
+    if (term.datatype !== undefined) {
+        return `"${escaped}"^^<${term.datatype}>`;
+    }
+    return `"${escaped}"`;
+}
+//# sourceMappingURL=pod.js.map

package/dist/pod.js.map

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

package/dist/react/index.d.ts

@@ -0,0 +1,52 @@
+/**
+ * React bindings (`@gaballahtech/seba/react`).
+ *
+ * `react` is an optional peer dependency: the core entry point never imports this file.
+ * The wrapper registers `<seba-login>` on mount, so no separate setup call is needed.
+ */
+import type { ReactElement } from "react";
+import type { SebaConfig, Session } from "../types.js";
+import type { Seba } from "../seba.js";
+/** Props accepted by {@link SebaLoginButton}. */
+export interface SebaLoginButtonProps {
+    /** Published Solid Client ID Document URL. */
+    clientId: string;
+    /** Redirect URI registered in the Client ID Document. Defaults to the current page URL. */
+    redirectUri?: string;
+    /** Identity provider issuer, used instead of WebID discovery. */
+    issuer?: string;
+    /** WebID whose profile lists the provider. */
+    webId?: string;
+    /** Button text while signed out. */
+    label?: string;
+    /** Colour scheme. Defaults to the system preference. */
+    theme?: "auto" | "light" | "dark";
+    /** Logo treatment, or `"none"`. Defaults to the theme's treatment. */
+    logo?: "primary" | "inverse" | "monochrome" | "solid" | "favicon" | "none";
+    /** Multi-account storage namespace. */
+    account?: string;
+    /** Advanced configuration (e.g. per-provider `tolerances`), serialized into the element. */
+    config?: Partial<Omit<SebaConfig, "clientId" | "redirectUri">>;
+    /** Identity providers offered in a picker; at least two are needed to show it. */
+    providers?: string[];
+    /** Extra class name for the host element. */
+    className?: string;
+    /** Called after a successful login or restore. */
+    onLogin?: (session: Session) => void;
+    /** Called after logout. */
+    onLogout?: () => void;
+    /** Called when the session expires. */
+    onSessionExpired?: () => void;
+    /** Called with any login, logout or configuration error. */
+    onError?: (error: unknown) => void;
+}
+/** A Solid sign-in button backed by `<seba-login>`. */
+export declare function SebaLoginButton(props: SebaLoginButtonProps): ReactElement;
+/**
+ * Track the session of a {@link Seba} instance.
+ *
+ * @returns The current session, or `null` while signed out. Updates on login,
+ *   restore, logout and expiry (expiry always yields `null`).
+ */
+export declare function useSession(seba: Seba | null | undefined): Session | null;
+//# sourceMappingURL=index.d.ts.map

package/dist/react/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/react/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,OAAO,CAAC;AAI1C,OAAO,KAAK,EAAE,UAAU,EAAE,OAAO,EAAE,MAAM,aAAa,CAAC;AACvD,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,YAAY,CAAC;AAEvC,iDAAiD;AACjD,MAAM,WAAW,oBAAoB;IACnC,8CAA8C;IAC9C,QAAQ,EAAE,MAAM,CAAC;IACjB,2FAA2F;IAC3F,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,iEAAiE;IACjE,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,8CAA8C;IAC9C,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,oCAAoC;IACpC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,wDAAwD;IACxD,KAAK,CAAC,EAAE,MAAM,GAAG,OAAO,GAAG,MAAM,CAAC;IAClC,sEAAsE;IACtE,IAAI,CAAC,EAAE,SAAS,GAAG,SAAS,GAAG,YAAY,GAAG,OAAO,GAAG,SAAS,GAAG,MAAM,CAAC;IAC3E,uCAAuC;IACvC,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,4FAA4F;IAC5F,MAAM,CAAC,EAAE,OAAO,CAAC,IAAI,CAAC,UAAU,EAAE,UAAU,GAAG,aAAa,CAAC,CAAC,CAAC;IAC/D,kFAAkF;IAClF,SAAS,CAAC,EAAE,MAAM,EAAE,CAAC;IACrB,6CAA6C;IAC7C,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,kDAAkD;IAClD,OAAO,CAAC,EAAE,CAAC,OAAO,EAAE,OAAO,KAAK,IAAI,CAAC;IACrC,2BAA2B;IAC3B,QAAQ,CAAC,EAAE,MAAM,IAAI,CAAC;IACtB,uCAAuC;IACvC,gBAAgB,CAAC,EAAE,MAAM,IAAI,CAAC;IAC9B,4DAA4D;IAC5D,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,OAAO,KAAK,IAAI,CAAC;CACpC;AAED,uDAAuD;AACvD,wBAAgB,eAAe,CAAC,KAAK,EAAE,oBAAoB,GAAG,YAAY,CAiDzE;AAED;;;;;GAKG;AACH,wBAAgB,UAAU,CAAC,IAAI,EAAE,IAAI,GAAG,IAAI,GAAG,SAAS,GAAG,OAAO,GAAG,IAAI,CAwBxE"}

package/dist/react/index.js

@@ -0,0 +1,87 @@
+/**
+ * React bindings (`@gaballahtech/seba/react`).
+ *
+ * `react` is an optional peer dependency: the core entry point never imports this file.
+ * The wrapper registers `<seba-login>` on mount, so no separate setup call is needed.
+ */
+import { createElement, useEffect, useRef, useState } from "react";
+import { defineSebaLogin } from "../element.js";
+/** A Solid sign-in button backed by `<seba-login>`. */
+export function SebaLoginButton(props) {
+    const host = useRef(null);
+    useEffect(() => {
+        defineSebaLogin();
+        const element = host.current;
+        if (element === null) {
+            return;
+        }
+        const onLogin = (event) => {
+            props.onLogin?.(event.detail.session);
+        };
+        const onLogout = () => {
+            props.onLogout?.();
+        };
+        const onExpired = () => {
+            props.onSessionExpired?.();
+        };
+        const onError = (event) => {
+            props.onError?.(event.detail.error);
+        };
+        element.addEventListener("seba:login", onLogin);
+        element.addEventListener("seba:restore", onLogin);
+        element.addEventListener("seba:logout", onLogout);
+        element.addEventListener("seba:session-expired", onExpired);
+        element.addEventListener("seba:error", onError);
+        return () => {
+            element.removeEventListener("seba:login", onLogin);
+            element.removeEventListener("seba:restore", onLogin);
+            element.removeEventListener("seba:logout", onLogout);
+            element.removeEventListener("seba:session-expired", onExpired);
+            element.removeEventListener("seba:error", onError);
+        };
+    }, [props.onLogin, props.onLogout, props.onSessionExpired, props.onError]);
+    return createElement("seba-login", {
+        ref: host,
+        "client-id": props.clientId,
+        ...(props.redirectUri === undefined ? {} : { "redirect-uri": props.redirectUri }),
+        ...(props.issuer === undefined ? {} : { issuer: props.issuer }),
+        ...(props.webId === undefined ? {} : { "web-id": props.webId }),
+        ...(props.label === undefined ? {} : { label: props.label }),
+        ...(props.theme === undefined ? {} : { theme: props.theme }),
+        ...(props.logo === undefined ? {} : { logo: props.logo }),
+        ...(props.account === undefined ? {} : { account: props.account }),
+        ...(props.providers === undefined ? {} : { providers: props.providers.join(" ") }),
+        ...(props.config === undefined ? {} : { config: JSON.stringify(props.config) }),
+        ...(props.className === undefined ? {} : { class: props.className }),
+    });
+}
+/**
+ * Track the session of a {@link Seba} instance.
+ *
+ * @returns The current session, or `null` while signed out. Updates on login,
+ *   restore, logout and expiry (expiry always yields `null`).
+ */
+export function useSession(seba) {
+    const [session, setSession] = useState(null);
+    useEffect(() => {
+        if (seba === null || seba === undefined) {
+            setSession(null);
+            return;
+        }
+        let active = true;
+        void seba.getSession().then((current) => {
+            if (active) {
+                setSession(current);
+            }
+        });
+        const unsubscribe = seba.onSessionChange((event) => {
+            setSession(event.session);
+        });
+        return () => {
+            active = false;
+            unsubscribe();
+        };
+    }, [seba]);
+    return session;
+}
+//# sourceMappingURL=index.js.map

package/dist/react/index.js.map

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

package/dist/seba.d.ts

@@ -4,7 +4,7 @@
  * The platform module is imported dynamically so a browser bundle never includes the
  * Node.js HTTP server and vice versa.
  */
-import type { LoginOptions, SebaConfig, Session } from "./types.js";
+import type { LoginOptions, SebaConfig, Session, SessionChangeListener, SessionInfo } from "./types.js";
 /**
  * Solid-OIDC client with four operations: {@link Seba.login}, {@link Seba.restoreSession},
  * {@link Seba.fetch} and {@link Seba.logout}.
@@ -22,15 +22,54 @@ import type { LoginOptions, SebaConfig, Session } from "./types.js";
  */
 export declare class Seba {
     #private;
+    /** Pod helpers: `parseSubjectTriples`, `objectify` and `toTurtle`. */
+    static readonly pod: {
+        parseSubjectTriples: typeof import("./pod.js").parseSubjectTriples;
+        objectify: typeof import("./pod.js").objectify;
+        toTurtle: typeof import("./pod.js").toTurtle;
+    };
     /**
      * @param config - Client ID Document URL, redirect URI and optional storage settings.
      *   Configuration is validated when the first operation runs.
      */
     constructor(config: SebaConfig);
+    /**
+     * Subscribe to session transitions (`login`, `restore`, `logout`, `expired`).
+     *
+     * @returns An unsubscribe function.
+     */
+    onSessionChange(listener: SessionChangeListener): () => void;
+    /** Remove a listener previously added with {@link Seba.onSessionChange}. */
+    offSessionChange(listener: SessionChangeListener): void;
+    /**
+     * Subscribe to the single `expired` transition of a session.
+     *
+     * @returns An unsubscribe function.
+     */
+    onSessionExpired(listener: SessionChangeListener): () => void;
+    /** Token-free current session, or `null` when signed out. */
+    getSession(): Promise<Session | null>;
     /** Start or finish an interactive login. See {@link SebaClient.login}. */
     login(options?: LoginOptions): Promise<Session>;
+    /**
+     * Complete a login whose callback URL is in the current address, WITHOUT starting a
+     * new one. Throws when no authorization response is present, so applications can
+     * call it on page load only when the URL actually carries `code`/`error` + `state`.
+     * This avoids the "login() never settles" redirect mode in explicit flows.
+     *
+     * @throws {@link SebaAuthError} when the current URL carries no callback parameters.
+     */
+    completeLogin(): Promise<Session>;
+    /** Whether the given (or current) URL carries an authorization response. */
+    static isCallbackResponse(url?: string | URL): boolean;
     /** Restore a stored session, or `null` when none exists. */
     restoreSession(): Promise<Session | null>;
+    /**
+     * Token-free details of the current session (WebID, provider and access-token
+     * expiry), or `null` when no session is active. Lets applications warn the user
+     * before the access token expires instead of failing mid-request.
+     */
+    getSessionInfo(): Promise<SessionInfo | null>;
     /** DPoP-authenticated `fetch`. Never forwards credentials to another origin. */
     fetch(input: RequestInfo | URL, init?: RequestInit): Promise<Response>;
     /** Sign out and revoke the refresh token when the provider supports it. */

package/dist/seba.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"seba.d.ts","sourceRoot":"","sources":["../src/seba.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,KAAK,EAAE,YAAY,EAAY,UAAU,EAAE,OAAO,EAAE,MAAM,YAAY,CAAC;AAY9E;;;;;;;;;;;;;;GAcG;AACH,qBAAa,IAAI;;IAGf;;;OAGG;gBACS,MAAM,EAAE,UAAU;IAI9B,0EAA0E;IACpE,KAAK,CAAC,OAAO,GAAE,YAAiB,GAAG,OAAO,CAAC,OAAO,CAAC;IAIzD,4DAA4D;IACtD,cAAc,IAAI,OAAO,CAAC,OAAO,GAAG,IAAI,CAAC;IAI/C,gFAAgF;IAC1E,KAAK,CAAC,KAAK,EAAE,WAAW,GAAG,GAAG,EAAE,IAAI,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,QAAQ,CAAC;IAI5E,2EAA2E;IACrE,MAAM,IAAI,OAAO,CAAC,IAAI,CAAC;CAG9B"}
+{"version":3,"file":"seba.d.ts","sourceRoot":"","sources":["../src/seba.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAKH,OAAO,KAAK,EACV,YAAY,EAEZ,UAAU,EACV,OAAO,EACP,qBAAqB,EACrB,WAAW,EACZ,MAAM,YAAY,CAAC;AAsBpB;;;;;;;;;;;;;;GAcG;AACH,qBAAa,IAAI;;IAIf,sEAAsE;IACtE,MAAM,CAAC,QAAQ,CAAC,GAAG;;;;MAAO;IAE1B;;;OAGG;gBACS,MAAM,EAAE,UAAU;IAY9B;;;;OAIG;IACH,eAAe,CAAC,QAAQ,EAAE,qBAAqB,GAAG,MAAM,IAAI;IAI5D,4EAA4E;IAC5E,gBAAgB,CAAC,QAAQ,EAAE,qBAAqB,GAAG,IAAI;IAIvD;;;;OAIG;IACH,gBAAgB,CAAC,QAAQ,EAAE,qBAAqB,GAAG,MAAM,IAAI;IAQ7D,6DAA6D;IACvD,UAAU,IAAI,OAAO,CAAC,OAAO,GAAG,IAAI,CAAC;IAI3C,0EAA0E;IACpE,KAAK,CAAC,OAAO,GAAE,YAAiB,GAAG,OAAO,CAAC,OAAO,CAAC;IAIzD;;;;;;;OAOG;IACG,aAAa,IAAI,OAAO,CAAC,OAAO,CAAC;IAIvC,4EAA4E;IAC5E,MAAM,CAAC,kBAAkB,CAAC,GAAG,CAAC,EAAE,MAAM,GAAG,GAAG,GAAG,OAAO;IAiBtD,4DAA4D;IACtD,cAAc,IAAI,OAAO,CAAC,OAAO,GAAG,IAAI,CAAC;IAI/C;;;;OAIG;IACG,cAAc,IAAI,OAAO,CAAC,WAAW,GAAG,IAAI,CAAC;IAInD,gFAAgF;IAC1E,KAAK,CAAC,KAAK,EAAE,WAAW,GAAG,GAAG,EAAE,IAAI,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,QAAQ,CAAC;IAI5E,2EAA2E;IACrE,MAAM,IAAI,OAAO,CAAC,IAAI,CAAC;CAG9B"}

package/dist/seba.js

@@ -4,7 +4,9 @@
  * The platform module is imported dynamically so a browser bundle never includes the
  * Node.js HTTP server and vice versa.
  */
-import { SebaClient } from "./core/client.js";
+import { SebaClient, isAuthorizationResponse } from "./core/client.js";
+import { SessionEmitter } from "./core/events.js";
+import { pod } from "./pod.js";
 async function loadPlatform() {
     const isBrowser = typeof window !== "undefined" && typeof document !== "undefined";
     if (isBrowser) {
@@ -14,6 +16,15 @@ async function loadPlatform() {
     const { createNodePlatform } = await import("./node/platform.js");
     return createNodePlatform();
 }
+async function loadNamespacer() {
+    const isBrowser = typeof window !== "undefined" && typeof document !== "undefined";
+    if (isBrowser) {
+        const { namespaceBrowserPlatform } = await import("./browser/platform.js");
+        return namespaceBrowserPlatform;
+    }
+    // Node.js sessions live in per-instance memory, so no namespacing is needed.
+    return (platform) => platform;
+}
 /**
  * Solid-OIDC client with four operations: {@link Seba.login}, {@link Seba.restoreSession},
  * {@link Seba.fetch} and {@link Seba.logout}.
@@ -31,21 +42,98 @@ async function loadPlatform() {
  */
 export class Seba {
     #client;
+    #events = new SessionEmitter();
+    /** Pod helpers: `parseSubjectTriples`, `objectify` and `toTurtle`. */
+    static pod = pod;
     /**
      * @param config - Client ID Document URL, redirect URI and optional storage settings.
      *   Configuration is validated when the first operation runs.
      */
     constructor(config) {
-        this.#client = loadPlatform().then((platform) => new SebaClient(config, platform));
+        this.#client = (async () => {
+            const [platform, namespacer] = await Promise.all([loadPlatform(), loadNamespacer()]);
+            const scoped = config.account === undefined ? platform : namespacer(platform, config.account);
+            return new SebaClient(config, scoped, {
+                onSessionChange: (event) => {
+                    this.#events.emit(event);
+                },
+            });
+        })();
+    }
+    /**
+     * Subscribe to session transitions (`login`, `restore`, `logout`, `expired`).
+     *
+     * @returns An unsubscribe function.
+     */
+    onSessionChange(listener) {
+        return this.#events.on(listener);
+    }
+    /** Remove a listener previously added with {@link Seba.onSessionChange}. */
+    offSessionChange(listener) {
+        this.#events.off(listener);
+    }
+    /**
+     * Subscribe to the single `expired` transition of a session.
+     *
+     * @returns An unsubscribe function.
+     */
+    onSessionExpired(listener) {
+        return this.onSessionChange((event) => {
+            if (event.reason === "expired") {
+                listener(event);
+            }
+        });
+    }
+    /** Token-free current session, or `null` when signed out. */
+    async getSession() {
+        return (await this.#client).session;
     }
     /** Start or finish an interactive login. See {@link SebaClient.login}. */
     async login(options = {}) {
         return (await this.#client).login(options);
     }
+    /**
+     * Complete a login whose callback URL is in the current address, WITHOUT starting a
+     * new one. Throws when no authorization response is present, so applications can
+     * call it on page load only when the URL actually carries `code`/`error` + `state`.
+     * This avoids the "login() never settles" redirect mode in explicit flows.
+     *
+     * @throws {@link SebaAuthError} when the current URL carries no callback parameters.
+     */
+    async completeLogin() {
+        return (await this.#client).completeLoginFromCurrentUrl();
+    }
+    /** Whether the given (or current) URL carries an authorization response. */
+    static isCallbackResponse(url) {
+        let target;
+        if (url === undefined) {
+            if (typeof window === "undefined") {
+                return false;
+            }
+            target = new URL(window.location.href);
+        }
+        else {
+            try {
+                target = url instanceof URL ? url : new URL(url);
+            }
+            catch {
+                return false;
+            }
+        }
+        return isAuthorizationResponse(target);
+    }
     /** Restore a stored session, or `null` when none exists. */
     async restoreSession() {
         return (await this.#client).restoreSession();
     }
+    /**
+     * Token-free details of the current session (WebID, provider and access-token
+     * expiry), or `null` when no session is active. Lets applications warn the user
+     * before the access token expires instead of failing mid-request.
+     */
+    async getSessionInfo() {
+        return (await this.#client).sessionInfo();
+    }
     /** DPoP-authenticated `fetch`. Never forwards credentials to another origin. */
     async fetch(input, init) {
         return (await this.#client).fetch(input, init);

package/dist/seba.js.map

@@ -1 +1 @@
-{"version":3,"file":"seba.js","sourceRoot":"","sources":["../src/seba.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAG9C,KAAK,UAAU,YAAY;IACzB,MAAM,SAAS,GAAG,OAAO,MAAM,KAAK,WAAW,IAAI,OAAO,QAAQ,KAAK,WAAW,CAAC;IACnF,IAAI,SAAS,EAAE,CAAC;QACd,MAAM,EAAE,qBAAqB,EAAE,GAAG,MAAM,MAAM,CAAC,uBAAuB,CAAC,CAAC;QACxE,OAAO,qBAAqB,EAAE,CAAC;IACjC,CAAC;IACD,MAAM,EAAE,kBAAkB,EAAE,GAAG,MAAM,MAAM,CAAC,oBAAoB,CAAC,CAAC;IAClE,OAAO,kBAAkB,EAAE,CAAC;AAC9B,CAAC;AAED;;;;;;;;;;;;;;GAcG;AACH,MAAM,OAAO,IAAI;IACN,OAAO,CAAsB;IAEtC;;;OAGG;IACH,YAAY,MAAkB;QAC5B,IAAI,CAAC,OAAO,GAAG,YAAY,EAAE,CAAC,IAAI,CAAC,CAAC,QAAQ,EAAE,EAAE,CAAC,IAAI,UAAU,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAC,CAAC;IACrF,CAAC;IAED,0EAA0E;IAC1E,KAAK,CAAC,KAAK,CAAC,UAAwB,EAAE;QACpC,OAAO,CAAC,MAAM,IAAI,CAAC,OAAO,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;IAC7C,CAAC;IAED,4DAA4D;IAC5D,KAAK,CAAC,cAAc;QAClB,OAAO,CAAC,MAAM,IAAI,CAAC,OAAO,CAAC,CAAC,cAAc,EAAE,CAAC;IAC/C,CAAC;IAED,gFAAgF;IAChF,KAAK,CAAC,KAAK,CAAC,KAAwB,EAAE,IAAkB;QACtD,OAAO,CAAC,MAAM,IAAI,CAAC,OAAO,CAAC,CAAC,KAAK,CAAC,KAAK,EAAE,IAAI,CAAC,CAAC;IACjD,CAAC;IAED,2EAA2E;IAC3E,KAAK,CAAC,MAAM;QACV,OAAO,CAAC,MAAM,IAAI,CAAC,OAAO,CAAC,CAAC,MAAM,EAAE,CAAC;IACvC,CAAC;CACF"}
+{"version":3,"file":"seba.js","sourceRoot":"","sources":["../src/seba.ts"],"names":[],"mappings":"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"}