fauna-api 0.0.0-stage → 1.0.679

package/dist/src/ui/index.js

@@ -0,0 +1,87 @@
+import * as DriveUI from "./drive.js";
+import * as HoverUI from "./hover.js";
+import * as ToastUI from "./toast.js";
+import * as ChatUI from "./chat.js";
+import * as GenerativeUI from "./generative.js";
+import * as TalkUI from "./talk.js";
+import * as TokenizedInputUI from "./tokenized.js";
+import * as IntegrationsUI from "./integrations.js";
+import * as AuthentificationUI from "./authentification.js";
+import * as DeviceUI from "./device.js";
+import * as CursorUI from "./cursor.js";
+import * as TicketsUI from "./tickets.js";
+import * as BrandsUI from "./brands.js";
+import * as BrowserUI from "./browser.js";
+import * as RosterUI from "./roster.js";
+import * as MapsUI from "./maps.js";
+import * as ViewUI from "./view.js";
+export var UI;
+(function (UI) {
+    var PREFIX = 'https://';
+    var IP = 'fauna.com';
+    var PORT = 443;
+    function setRoute(route) {
+        const parts_0 = route.split('//');
+        if (parts_0.length > 1) {
+            PREFIX = parts_0[0] + '//';
+            const parts_1 = parts_0[1].split(':');
+            if (parts_1.length > 1) {
+                IP = parts_1[0];
+                PORT = Number(parts_1[1]);
+            }
+            else {
+                IP = parts_1[0];
+            }
+        }
+        else {
+            const parts_1 = parts_0[0].split(':');
+            if (parts_1.length > 1) {
+                IP = parts_1[0];
+                PORT = Number(parts_1[1]);
+            }
+            else {
+                IP = parts_1[0];
+            }
+        }
+    }
+    UI.setRoute = setRoute;
+    function getIP() {
+        return IP;
+    }
+    UI.getIP = getIP;
+    function getPort() {
+        return PORT;
+    }
+    UI.getPort = getPort;
+    function getRoute() {
+        return IP + ':' + PORT;
+    }
+    UI.getRoute = getRoute;
+    function getURL() {
+        return PREFIX + IP + ':' + PORT;
+    }
+    UI.getURL = getURL;
+    async function ping() {
+        const start = Date.now();
+        await fetch(`${getURL()}/`);
+        return Date.now() - start;
+    }
+    UI.ping = ping;
+    UI.File = DriveUI;
+    UI.Hover = HoverUI;
+    UI.Toast = ToastUI;
+    UI.Chat = ChatUI;
+    UI.Generative = GenerativeUI;
+    UI.Talk = TalkUI;
+    UI.TokenizedInput = TokenizedInputUI;
+    UI.Integrations = IntegrationsUI;
+    UI.Authentification = AuthentificationUI;
+    UI.Device = DeviceUI;
+    UI.Cursor = CursorUI;
+    UI.Tickets = TicketsUI;
+    UI.Brands = BrandsUI;
+    UI.Browser = BrowserUI;
+    UI.Roster = RosterUI;
+    UI.Maps = MapsUI;
+    UI.View = ViewUI;
+})(UI || (UI = {}));

package/dist/src/ui/integrations.d.ts

@@ -0,0 +1,13 @@
+import { Fauna } from "fauna-api";
+import { Credentials } from "../authentification.js";
+export type ConnectionsOptions = Partial<{
+    platforms: Fauna.Integrations.Platform[];
+    unlink: boolean;
+    onLinked: (platform: Fauna.Integrations.Platform) => void;
+    onUnlinked: (account: Fauna.Integrations.Account) => void;
+    onError: (error: Error) => void;
+}>;
+export declare function createConnections(credentials: Credentials, options?: ConnectionsOptions): {
+    getElement: () => HTMLElement;
+    refresh: () => Promise<void>;
+};

package/dist/src/ui/integrations.js

@@ -0,0 +1,175 @@
+import { Fauna } from "fauna-api";
+import gsap from "gsap";
+// Brand logos as inline SVG (currentColor-free, real brand marks) so the
+// connections panel reads as a polished product surface rather than generic
+// glyph buttons. Sized to a 24px box; the card controls final dimensions.
+const PLATFORM_LOGOS = {
+    [Fauna.Integrations.Platform.GOOGLE]: `<svg viewBox="0 0 24 24" width="24" height="24" aria-hidden="true"><path fill="#4285F4" d="M23.49 12.27c0-.79-.07-1.54-.2-2.27H12v4.51h6.47a5.53 5.53 0 0 1-2.4 3.63v3h3.88c2.27-2.09 3.54-5.17 3.54-8.87z"/><path fill="#34A853" d="M12 24c3.24 0 5.95-1.08 7.93-2.91l-3.88-3c-1.08.72-2.45 1.16-4.05 1.16-3.12 0-5.76-2.11-6.71-4.94H1.29v3.09A12 12 0 0 0 12 24z"/><path fill="#FBBC05" d="M5.29 14.31a7.2 7.2 0 0 1 0-4.62V6.6H1.29a12 12 0 0 0 0 10.8l4-3.09z"/><path fill="#EA4335" d="M12 4.75c1.77 0 3.35.61 4.6 1.8l3.42-3.42A11.97 11.97 0 0 0 12 0 12 12 0 0 0 1.29 6.6l4 3.09C6.24 6.86 8.88 4.75 12 4.75z"/></svg>`,
+    [Fauna.Integrations.Platform.MICROSOFT]: `<svg viewBox="0 0 24 24" width="24" height="24" aria-hidden="true"><path fill="#0A2767" d="M24 12.34a.78.78 0 0 0-.38-.67l-.01-.01-8-4.73a1.07 1.07 0 0 0-1.16 0l-8 4.73-.01.01a.78.78 0 0 0 .03 1.35l8 4.73c.36.21.8.21 1.16 0l8-4.73a.78.78 0 0 0 .35-.62z"/><path fill="#0364B8" d="M6.92 8.9h4.96v4.55H6.92zM22.95 4H12.6v3.43l2.34 1.39.06.02 7.95-4.7V4.4a.4.4 0 0 0-.4-.4z"/><path fill="#0078D4" d="M12.6 7.43L14.94 8.82l-2.34 1.39z"/><path fill="#28A8EA" d="M12.6 7.43V4H6.92v4.9h4.96v1.31l.72-.4z"/><path fill="#0078D4" d="M.4 4h6.52a.4.4 0 0 1 .4.4v15.2a.4.4 0 0 1-.4.4H.4a.4.4 0 0 1-.4-.4V4.4A.4.4 0 0 1 .4 4z" transform="translate(0 0)"/><path fill="#fff" d="M3.66 8.3a2.93 2.93 0 0 0-2.6 1.5 4.7 4.7 0 0 0-.5 2.27 4.46 4.46 0 0 0 .49 2.16 2.83 2.83 0 0 0 2.51 1.46 2.87 2.87 0 0 0 2.55-1.48 4.6 4.6 0 0 0 .49-2.2 4.94 4.94 0 0 0-.46-2.21A2.78 2.78 0 0 0 3.66 8.3zm-.06 5.96c-1 0-1.45-.95-1.45-2.18 0-1.3.5-2.2 1.45-2.2.97 0 1.42.93 1.42 2.16 0 1.3-.45 2.22-1.42 2.22z"/></svg>`,
+    [Fauna.Integrations.Platform.SLACK]: `<svg viewBox="0 0 24 24" width="24" height="24" aria-hidden="true"><path fill="#E01E5A" d="M5.04 15.16a2.52 2.52 0 0 1-2.52 2.52A2.52 2.52 0 0 1 0 15.16a2.52 2.52 0 0 1 2.52-2.52h2.52v2.52zm1.27 0a2.52 2.52 0 0 1 2.52-2.52 2.52 2.52 0 0 1 2.52 2.52v6.32A2.52 2.52 0 0 1 8.83 24a2.52 2.52 0 0 1-2.52-2.52v-6.32z"/><path fill="#36C5F0" d="M8.83 5.04a2.52 2.52 0 0 1-2.52-2.52A2.52 2.52 0 0 1 8.83 0a2.52 2.52 0 0 1 2.52 2.52v2.52H8.83zm0 1.27a2.52 2.52 0 0 1 2.52 2.52 2.52 2.52 0 0 1-2.52 2.52H2.52A2.52 2.52 0 0 1 0 8.83a2.52 2.52 0 0 1 2.52-2.52h6.31z"/><path fill="#2EB67D" d="M18.96 8.83a2.52 2.52 0 0 1 2.52-2.52A2.52 2.52 0 0 1 24 8.83a2.52 2.52 0 0 1-2.52 2.52h-2.52V8.83zm-1.27 0a2.52 2.52 0 0 1-2.52 2.52 2.52 2.52 0 0 1-2.52-2.52V2.52A2.52 2.52 0 0 1 15.17 0a2.52 2.52 0 0 1 2.52 2.52v6.31z"/><path fill="#ECB22E" d="M15.17 18.96a2.52 2.52 0 0 1 2.52 2.52A2.52 2.52 0 0 1 15.17 24a2.52 2.52 0 0 1-2.52-2.52v-2.52h2.52zm0-1.27a2.52 2.52 0 0 1-2.52-2.52 2.52 2.52 0 0 1 2.52-2.52h6.31A2.52 2.52 0 0 1 24 15.17a2.52 2.52 0 0 1-2.52 2.52h-6.31z"/></svg>`,
+    [Fauna.Integrations.Platform.DISCORD]: `<svg viewBox="0 0 24 24" width="24" height="24" aria-hidden="true"><path fill="#5865F2" d="M20.32 4.37a19.8 19.8 0 0 0-4.88-1.51.07.07 0 0 0-.08.04c-.21.38-.44.87-.6 1.25a18.27 18.27 0 0 0-5.5 0 12.6 12.6 0 0 0-.61-1.25.08.08 0 0 0-.08-.04 19.74 19.74 0 0 0-4.88 1.51.07.07 0 0 0-.03.03C.53 9.05-.32 13.58.1 18.06a.08.08 0 0 0 .03.06 19.9 19.9 0 0 0 5.99 3.03.08.08 0 0 0 .08-.03c.46-.63.87-1.29 1.22-1.99a.08.08 0 0 0-.04-.11c-.65-.25-1.27-.55-1.87-.89a.08.08 0 0 1-.01-.13l.37-.29a.07.07 0 0 1 .08-.01 14.2 14.2 0 0 0 12.06 0 .07.07 0 0 1 .08 0l.37.3a.08.08 0 0 1-.01.13c-.6.35-1.22.64-1.87.89a.08.08 0 0 0-.04.11c.36.7.77 1.36 1.22 1.99a.08.08 0 0 0 .08.03 19.84 19.84 0 0 0 6-3.03.08.08 0 0 0 .03-.06c.5-5.18-.84-9.67-3.55-13.66a.06.06 0 0 0-.03-.03zM8.02 15.33c-1.18 0-2.16-1.08-2.16-2.42 0-1.33.96-2.42 2.16-2.42 1.21 0 2.18 1.1 2.16 2.42 0 1.34-.96 2.42-2.16 2.42zm7.97 0c-1.18 0-2.15-1.08-2.15-2.42 0-1.33.95-2.42 2.15-2.42 1.21 0 2.18 1.1 2.16 2.42 0 1.34-.95 2.42-2.16 2.42z"/></svg>`,
+    [Fauna.Integrations.Platform.TWILIO]: `<svg viewBox="0 0 24 24" width="24" height="24" aria-hidden="true"><path fill="#F22F46" d="M12 0a12 12 0 1 0 0 24 12 12 0 0 0 0-24zm0 20.4a8.4 8.4 0 1 1 0-16.8 8.4 8.4 0 0 1 0 16.8zm4.97-10.42a2.06 2.06 0 1 1-4.12 0 2.06 2.06 0 0 1 4.12 0zm0 4.08a2.06 2.06 0 1 1-4.12 0 2.06 2.06 0 0 1 4.12 0zm-4.08 0a2.06 2.06 0 1 1-4.12 0 2.06 2.06 0 0 1 4.12 0zm0-4.08a2.06 2.06 0 1 1-4.12 0 2.06 2.06 0 0 1 4.12 0z"/></svg>`,
+    [Fauna.Integrations.Platform.WHATSAPP]: `<svg viewBox="0 0 24 24" width="24" height="24" aria-hidden="true"><path fill="#25D366" d="M.06 24l1.68-6.16a11.87 11.87 0 0 1-1.59-5.95C.15 5.32 5.5 0 12.06 0a11.8 11.8 0 0 1 8.41 3.49 11.74 11.74 0 0 1 3.48 8.4c0 6.55-5.35 11.88-11.94 11.88a12 12 0 0 1-5.7-1.45L.06 24z"/><path fill="#fff" d="M9.03 6.95c-.22-.49-.45-.5-.66-.51l-.56-.01c-.2 0-.51.07-.78.37-.27.3-1.02 1-1.02 2.43s1.05 2.82 1.2 3.01c.15.2 2.03 3.25 5.02 4.43 2.48.98 2.99.79 3.53.74.54-.05 1.74-.71 1.98-1.4.25-.69.25-1.28.17-1.4-.07-.12-.27-.2-.56-.34-.3-.15-1.74-.86-2.01-.96-.27-.1-.47-.15-.66.15-.2.3-.76.95-.93 1.15-.17.2-.34.22-.63.07-.3-.15-1.25-.46-2.38-1.47-.88-.78-1.47-1.75-1.64-2.05-.17-.3-.02-.46.13-.6.13-.14.3-.36.45-.53.15-.18.2-.3.3-.5.1-.2.05-.38-.02-.53-.08-.15-.65-1.6-.92-2.18z"/></svg>`
+};
+// Per-platform presentation + the scope bundle to request on link. Apps can
+// override the bundle/label/icon/color through options.
+const PLATFORM_META = {
+    [Fauna.Integrations.Platform.GOOGLE]: { label: 'Google', icon: 'mail', color: '#ea4335' },
+    [Fauna.Integrations.Platform.SLACK]: { label: 'Slack', icon: 'tag', color: '#4a154b' },
+    [Fauna.Integrations.Platform.DISCORD]: { label: 'Discord', icon: 'forum', color: '#5865f2' },
+    [Fauna.Integrations.Platform.TWILIO]: { label: 'SMS', icon: 'sms', color: '#34d399' },
+    [Fauna.Integrations.Platform.MICROSOFT]: { label: 'Microsoft', icon: 'mail', color: '#0078d4' },
+    [Fauna.Integrations.Platform.WHATSAPP]: { label: 'WhatsApp', icon: 'chat', color: '#25d366' }
+};
+// The human label for a linked account — whatever the platform identifies it by.
+function accountLabel(account) {
+    if (account instanceof Fauna.Integrations.Google)
+        return account.email;
+    if (account instanceof Fauna.Integrations.Slack)
+        return account.email;
+    if (account instanceof Fauna.Integrations.Discord)
+        return account.handle;
+    if (account instanceof Fauna.Integrations.Twilio)
+        return account.phone;
+    if (account instanceof Fauna.Integrations.Microsoft)
+        return account.email;
+    if (account instanceof Fauna.Integrations.WhatsApp)
+        return account.phone;
+    return account.platform;
+}
+// A drop-in connections panel: a responsive card grid, one card per platform,
+// each showing the brand logo, the platform name, any linked accounts (with an
+// unlink control), and a connect button. Handles the OAuth popup and refreshes
+// itself once it closes. Neutral, product-grade styling that doesn't lean on a
+// host app's accent color.
+export function createConnections(credentials, options = {}) {
+    const platforms = options.platforms ?? Object.values(Fauna.Integrations.Platform);
+    const root = document.createElement('div');
+    root.className = 'connections-root';
+    const grid = document.createElement('div');
+    grid.className = 'connections-grid';
+    root.appendChild(grid);
+    function fail(err) {
+        options.onError?.(err instanceof Error ? err : new Error(String(err)));
+    }
+    async function connect(platform) {
+        try {
+            const popup = await Fauna.Integrations.linkPlatform(credentials, platform);
+            if (!popup)
+                return;
+            // Refresh once the consent popup closes.
+            const timer = setInterval(async () => {
+                if (popup.closed) {
+                    clearInterval(timer);
+                    await refresh();
+                    options.onLinked?.(platform);
+                }
+            }, 1000);
+        }
+        catch (err) {
+            fail(err);
+        }
+    }
+    // One card per platform. `accounts` are the already-linked accounts for this
+    // platform (possibly several); each gets a labeled row with an unlink action.
+    function buildCard(platform, accounts) {
+        const meta = PLATFORM_META[platform];
+        const card = document.createElement('div');
+        card.className = 'connection-card' + (accounts.length ? ' connected' : '');
+        const head = document.createElement('div');
+        head.className = 'connection-card-head';
+        const logo = document.createElement('span');
+        logo.className = 'connection-card-logo';
+        logo.innerHTML = PLATFORM_LOGOS[platform] ?? '';
+        head.appendChild(logo);
+        const titles = document.createElement('div');
+        titles.className = 'connection-card-titles';
+        const name = document.createElement('span');
+        name.className = 'connection-card-name';
+        name.textContent = meta.label;
+        titles.appendChild(name);
+        const status = document.createElement('span');
+        status.className = 'connection-card-status';
+        status.textContent = accounts.length
+            ? `${accounts.length} connected`
+            : 'Not connected';
+        titles.appendChild(status);
+        head.appendChild(titles);
+        if (accounts.length) {
+            const badge = document.createElement('span');
+            badge.className = 'material-symbols-outlined connection-card-check';
+            badge.textContent = 'check_circle';
+            head.appendChild(badge);
+        }
+        card.appendChild(head);
+        // Linked account rows (label + unlink).
+        if (accounts.length) {
+            const accountsBox = document.createElement('div');
+            accountsBox.className = 'connection-card-accounts';
+            for (const account of accounts) {
+                const row = document.createElement('div');
+                row.className = 'connection-account';
+                const label = document.createElement('span');
+                label.className = 'connection-account-label';
+                label.textContent = accountLabel(account);
+                label.title = accountLabel(account);
+                row.appendChild(label);
+                if (options.unlink) {
+                    const remove = document.createElement('button');
+                    remove.type = 'button';
+                    remove.className = 'connection-account-unlink';
+                    remove.title = 'Disconnect';
+                    remove.innerHTML = '<span class="material-symbols-outlined">close</span>';
+                    remove.onclick = async () => {
+                        try {
+                            await account.unlink();
+                            options.onUnlinked?.(account);
+                            await refresh();
+                        }
+                        catch (err) {
+                            fail(err);
+                        }
+                    };
+                    row.appendChild(remove);
+                }
+                accountsBox.appendChild(row);
+            }
+            card.appendChild(accountsBox);
+        }
+        // Connect / add-another action.
+        const connectBtn = document.createElement('button');
+        connectBtn.type = 'button';
+        connectBtn.className = 'connection-card-connect';
+        connectBtn.innerHTML = `<span class="material-symbols-outlined">add</span><span>${accounts.length ? 'Add another' : 'Connect'}</span>`;
+        connectBtn.onclick = () => connect(platform);
+        card.appendChild(connectBtn);
+        return card;
+    }
+    async function refresh() {
+        try {
+            const accounts = await Fauna.Integrations.getAccounts(credentials);
+            const byPlatform = new Map();
+            for (const account of accounts) {
+                if (!platforms.includes(account.platform))
+                    continue;
+                const list = byPlatform.get(account.platform) ?? [];
+                list.push(account);
+                byPlatform.set(account.platform, list);
+            }
+            grid.replaceChildren();
+            for (const platform of platforms) {
+                grid.appendChild(buildCard(platform, byPlatform.get(platform) ?? []));
+            }
+            // Subtle entrance so the grid doesn't pop in.
+            gsap.fromTo(grid.children, { opacity: 0, y: 8 }, { opacity: 1, y: 0, duration: 0.3, stagger: 0.04, ease: 'power2.out' });
+        }
+        catch (err) {
+            fail(err);
+        }
+    }
+    refresh();
+    return {
+        getElement: () => root,
+        refresh
+    };
+}

package/dist/src/ui/maps.d.ts

@@ -0,0 +1,87 @@
+import { type CSSProperties } from "react";
+import maplibregl from "maplibre-gl";
+import type { ApiKey, Credentials } from "../authentification.js";
+import type { Group } from "../groups.js";
+import type { Coordinates, MapTheme, Place, Route, TravelMode, Units } from "../maps.js";
+import type { Flight, Offer } from "../travel.js";
+/** Where maps calls go: straight to Fauna with `authorization` (billed to it, or to
+ *  `group`), or to `proxy`, an app server that serves Fauna's /maps routes. */
+export type MapsSource = {
+    authorization?: Credentials | ApiKey;
+    group?: Group;
+    proxy?: string;
+    /** Sent with every proxy call, e.g. the app's own sign in. */
+    headers?: Record<string, string>;
+};
+export type MapMarker = {
+    id: string;
+    coordinates: Coordinates;
+    label?: string;
+    tone?: "accent" | "muted";
+};
+export type MapOptions = MapsSource & {
+    theme?: MapTheme;
+    center?: Coordinates;
+    zoom?: number;
+    markers?: MapMarker[];
+    routes?: Route[];
+    /** Fit the view to the markers and routes whenever they change. Default true. */
+    fit?: boolean;
+    interactive?: boolean;
+    /** Tiles each pass buys. Default 150. */
+    tiles?: number;
+    /** Passes one map may buy as it is panned around. Default 4. */
+    maxPasses?: number;
+    onMarkerClick?: (marker: MapMarker) => void;
+};
+export type MapInstance = {
+    map: maplibregl.Map | undefined;
+    update(options: Partial<MapOptions>): void;
+    destroy(): void;
+};
+/**
+ * A map drawn from prepaid tile passes, with markers and route lines. A pass that
+ * runs out is replaced, up to `maxPasses`. The attribution the pass carries is
+ * always shown, as the tile provider's terms require.
+ */
+export declare function createMap(container: HTMLElement, initial: MapOptions): MapInstance;
+/** A map for React. The source and theme are fixed for its life; markers, routes and the view follow props. */
+export declare function Map(props: MapOptions & {
+    className?: string;
+    style?: CSSProperties;
+}): import("react").JSX.Element;
+export declare function formatDuration(seconds: number): string;
+export declare function formatDistance(meters: number, units?: Units): string;
+export declare function formatMoney(amount: number, currency: string): string;
+/** Open where to book: a link, or a form posted in a new tab when the offer carries one. */
+export declare function openOffer(offer: Offer): void;
+export type DirectionsProps = {
+    routes: Route[];
+    flights?: Flight[];
+    units?: Units;
+    /** The mode to open on. Defaults to `recommended`, else the first there is. */
+    mode?: TravelMode;
+    /** Marked as the best way there. */
+    recommended?: TravelMode;
+    onMode?: (mode: TravelMode) => void;
+    /** Where a flight can be booked; the Book button lists these. */
+    offers?: (flight: Flight) => Promise<Offer[]>;
+    className?: string;
+};
+/** Ways to get somewhere: a tab per mode, the time, distance and cost, and the steps or flights. */
+export declare function Directions({ routes, flights, units, mode, recommended, onMode, offers, className }: DirectionsProps): import("react").JSX.Element;
+export type PlaceSearchProps = MapsSource & {
+    onSelect: (place: Place) => void;
+    near?: Coordinates;
+    placeholder?: string;
+    defaultValue?: string;
+    autoFocus?: boolean;
+    className?: string;
+};
+/** A text box that suggests places as someone types and hands back the one they pick. */
+export declare function PlaceSearch({ onSelect, near, placeholder, defaultValue, autoFocus, className, ...source }: PlaceSearchProps): import("react").JSX.Element;
+/** Place search for apps without React. */
+export declare function mountPlaceSearch(element: HTMLElement, props: PlaceSearchProps): {
+    update(props: PlaceSearchProps): void;
+    destroy(): void;
+};