vana-cli 0.15.0

package/dist/personal-server/index.js

@@ -0,0 +1,157 @@
+import fs from "node:fs/promises";
+import { readCliConfig } from "../core/state-store.js";
+import { resolveScopes } from "./scope-resolver.js";
+import { createPersonalServerClient } from "./client.js";
+import { readCachedConnectorMetadata } from "../connectors/registry.js";
+import { getConnectorCacheDir } from "../core/paths.js";
+import { loadCredentials } from "../cli/auth.js";
+export { createPersonalServerClient } from "./client.js";
+const DEFAULT_PORTS = [8080, 8081, 8082, 8083, 8084, 8085];
+async function detectTargetAt(url, source) {
+    const health = await fetchHealth(url);
+    if (!health) {
+        return null;
+    }
+    return {
+        state: "available",
+        url,
+        source,
+        health,
+    };
+}
+export async function detectPersonalServerTarget() {
+    // 1. Persisted config (highest priority)
+    const config = await readCliConfig();
+    if (config.personalServerUrl) {
+        const target = await detectTargetAt(config.personalServerUrl, "config");
+        if (target) {
+            return target;
+        }
+    }
+    // 2. Auth credentials (from `vana login`)
+    const authCreds = loadCredentials();
+    if (authCreds?.personal_server?.url) {
+        const target = await detectTargetAt(authCreds.personal_server.url, "auth");
+        if (target) {
+            return target;
+        }
+    }
+    // 3. Environment variable
+    const explicitUrl = process.env.VANA_PERSONAL_SERVER_URL;
+    if (explicitUrl) {
+        const target = await detectTargetAt(explicitUrl, "env");
+        if (target) {
+            return target;
+        }
+    }
+    // 3. Localhost port scan
+    for (const port of DEFAULT_PORTS) {
+        const url = `http://localhost:${port}`;
+        const health = await fetchHealth(url);
+        if (health) {
+            return { state: "available", url, source: "scan", health };
+        }
+    }
+    return { state: "unavailable", url: null, source: null, health: null };
+}
+export async function ingestResult(source, resultPath, target, options) {
+    if (target.state !== "available" || !target.url) {
+        return [
+            {
+                type: "ingest-skipped",
+                source,
+                reason: "personal_server_unavailable",
+            },
+        ];
+    }
+    const raw = await fs.readFile(resultPath, "utf8");
+    const result = JSON.parse(raw);
+    const metadata = await readCachedConnectorMetadata(source, getConnectorCacheDir());
+    const selectedScopes = options?.scopes ? new Set(options.scopes) : null;
+    const scopeMappings = resolveScopes(source, result, metadata).filter((mapping) => !selectedScopes || selectedScopes.has(mapping.scope));
+    if (scopeMappings.length === 0) {
+        return [
+            {
+                type: "ingest-skipped",
+                source,
+                reason: "no_scopes_resolved",
+            },
+        ];
+    }
+    const client = createPersonalServerClient({
+        url: target.url,
+        auth: resolvePersonalServerAuthConfig(target.url),
+    });
+    const events = [
+        { type: "ingest-started", source, target: target.url },
+    ];
+    const scopeResults = [];
+    for (const mapping of scopeMappings) {
+        const scopeResult = await client.ingestScope(mapping.scope, mapping.data);
+        scopeResults.push(scopeResult);
+    }
+    const allStored = scopeResults.every((r) => r.status === "stored");
+    const allFailed = scopeResults.every((r) => r.status === "failed");
+    if (allStored) {
+        events.push({
+            type: "ingest-complete",
+            source,
+            target: target.url,
+            scopeResults,
+        });
+    }
+    else if (allFailed) {
+        events.push({
+            type: "ingest-failed",
+            source,
+            target: target.url,
+            message: scopeResults.map((r) => `${r.scope}: ${r.error}`).join("; "),
+            scopeResults,
+        });
+    }
+    else {
+        events.push({
+            type: "ingest-partial",
+            source,
+            target: target.url,
+            scopeResults,
+        });
+    }
+    return events;
+}
+export function resolvePersonalServerAuthConfig(serverUrl) {
+    const psToken = process.env.VANA_PS_TOKEN;
+    if (psToken) {
+        return { type: "bearerToken", token: psToken };
+    }
+    const creds = loadCredentials();
+    if (creds?.personal_server?.session_token &&
+        urlsMatch(creds.personal_server.url, serverUrl)) {
+        return { type: "bearerToken", token: creds.personal_server.session_token };
+    }
+    return undefined;
+}
+function urlsMatch(left, right) {
+    return left.replace(/\/+$/, "") === right.replace(/\/+$/, "");
+}
+async function fetchHealth(baseUrl) {
+    try {
+        const response = await fetch(`${baseUrl}/health`, {
+            method: "GET",
+            signal: AbortSignal.timeout(2_000),
+        });
+        if (!response.ok)
+            return null;
+        const body = (await response.json());
+        return {
+            status: typeof body.status === "string" ? body.status : "unknown",
+            version: typeof body.version === "string" ? body.version : "unknown",
+            uptime: typeof body.uptime === "number" ? body.uptime : 0,
+            owner: typeof body.owner === "string" ? body.owner : null,
+        };
+    }
+    catch {
+        return null;
+    }
+}
+//# sourceMappingURL=index.js.map

package/dist/personal-server/index.js.map

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

package/dist/personal-server/scope-resolver.d.ts

@@ -0,0 +1,22 @@
+import type { ConnectorMetadata } from "../connectors/registry.js";
+export interface ScopeMapping {
+    scope: string;
+    data: unknown;
+}
+/**
+ * Resolve connector output keys to personal server scopes.
+ *
+ * Strategy (matches DataConnect production):
+ * 1. If any output keys contain ".", use them directly as scopes
+ * 2. Otherwise, use connector metadata to map: metadata scope "github.profile"
+ *    → look for key "profile" in result
+ * 3. If no metadata, fall back to "{source}.{key}" for every non-metadata key
+ *    (exclude: exportSummary, timestamp, version, platform)
+ *
+ * @param source - The connector source name (e.g. "github")
+ * @param result - The connector output as key-value pairs
+ * @param metadata - Optional connector metadata with scope definitions
+ * @returns An array of scope mappings
+ */
+export declare function resolveScopes(source: string, result: Record<string, unknown>, metadata: ConnectorMetadata | null): ScopeMapping[];
+//# sourceMappingURL=scope-resolver.d.ts.map

package/dist/personal-server/scope-resolver.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"scope-resolver.d.ts","sourceRoot":"","sources":["../../src/personal-server/scope-resolver.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,2BAA2B,CAAC;AAEnE,MAAM,WAAW,YAAY;IAC3B,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,OAAO,CAAC;CACf;AAoCD;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,aAAa,CAC3B,MAAM,EAAE,MAAM,EACd,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC/B,QAAQ,EAAE,iBAAiB,GAAG,IAAI,GACjC,YAAY,EAAE,CAsChB"}

package/dist/personal-server/scope-resolver.js

@@ -0,0 +1,80 @@
+/** Keys that are connector metadata, not user data. */
+const EXCLUDED_KEYS = new Set([
+    "exportSummary",
+    "timestamp",
+    "version",
+    "platform",
+]);
+/**
+ * Ensure scope data is a JSON object for the Personal Server API.
+ * Arrays are wrapped as `{ items: [...] }`. Primitives are wrapped
+ * as `{ value: ... }`. Objects pass through unchanged.
+ */
+function ensureObject(data) {
+    if (Array.isArray(data)) {
+        return { items: data };
+    }
+    if (data !== null && typeof data === "object") {
+        return data;
+    }
+    return { value: data };
+}
+function normalizeScopeSegment(segment) {
+    return segment
+        .replace(/([a-z0-9])([A-Z])/g, "$1_$2")
+        .replace(/[\s-]+/g, "_")
+        .toLowerCase();
+}
+function normalizeScope(scope) {
+    return scope.split(".").filter(Boolean).map(normalizeScopeSegment).join(".");
+}
+/**
+ * Resolve connector output keys to personal server scopes.
+ *
+ * Strategy (matches DataConnect production):
+ * 1. If any output keys contain ".", use them directly as scopes
+ * 2. Otherwise, use connector metadata to map: metadata scope "github.profile"
+ *    → look for key "profile" in result
+ * 3. If no metadata, fall back to "{source}.{key}" for every non-metadata key
+ *    (exclude: exportSummary, timestamp, version, platform)
+ *
+ * @param source - The connector source name (e.g. "github")
+ * @param result - The connector output as key-value pairs
+ * @param metadata - Optional connector metadata with scope definitions
+ * @returns An array of scope mappings
+ */
+export function resolveScopes(source, result, metadata) {
+    const keys = Object.keys(result);
+    // Strategy 1: If any keys are already dotted scopes, use them directly.
+    const dottedKeys = keys.filter((key) => key.includes(".") && !EXCLUDED_KEYS.has(key));
+    if (dottedKeys.length > 0) {
+        return dottedKeys.map((key) => ({
+            scope: normalizeScope(key),
+            data: ensureObject(result[key]),
+        }));
+    }
+    // Strategy 2: Use metadata scopes to map flat keys.
+    if (metadata?.scopes && metadata.scopes.length > 0) {
+        const mappings = [];
+        for (const { scope } of metadata.scopes) {
+            // Extract the key portion after the dot, e.g. "github.profile" → "profile"
+            const dotIndex = scope.indexOf(".");
+            const key = dotIndex >= 0 ? scope.slice(dotIndex + 1) : scope;
+            if (key in result) {
+                mappings.push({
+                    scope: normalizeScope(scope),
+                    data: ensureObject(result[key]),
+                });
+            }
+        }
+        return mappings;
+    }
+    // Strategy 3: Fall back to "{source}.{key}" for every non-metadata key.
+    return keys
+        .filter((key) => !EXCLUDED_KEYS.has(key))
+        .map((key) => ({
+        scope: normalizeScope(`${source}.${key}`),
+        data: ensureObject(result[key]),
+    }));
+}
+//# sourceMappingURL=scope-resolver.js.map

package/dist/personal-server/scope-resolver.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"scope-resolver.js","sourceRoot":"","sources":["../../src/personal-server/scope-resolver.ts"],"names":[],"mappings":"AAOA,uDAAuD;AACvD,MAAM,aAAa,GAAG,IAAI,GAAG,CAAC;IAC5B,eAAe;IACf,WAAW;IACX,SAAS;IACT,UAAU;CACX,CAAC,CAAC;AAEH;;;;GAIG;AACH,SAAS,YAAY,CAAC,IAAa;IACjC,IAAI,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,CAAC;QACxB,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC;IACzB,CAAC;IACD,IAAI,IAAI,KAAK,IAAI,IAAI,OAAO,IAAI,KAAK,QAAQ,EAAE,CAAC;QAC9C,OAAO,IAA+B,CAAC;IACzC,CAAC;IACD,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC;AACzB,CAAC;AAED,SAAS,qBAAqB,CAAC,OAAe;IAC5C,OAAO,OAAO;SACX,OAAO,CAAC,oBAAoB,EAAE,OAAO,CAAC;SACtC,OAAO,CAAC,SAAS,EAAE,GAAG,CAAC;SACvB,WAAW,EAAE,CAAC;AACnB,CAAC;AAED,SAAS,cAAc,CAAC,KAAa;IACnC,OAAO,KAAK,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,GAAG,CAAC,qBAAqB,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AAC/E,CAAC;AAED;;;;;;;;;;;;;;GAcG;AACH,MAAM,UAAU,aAAa,CAC3B,MAAc,EACd,MAA+B,EAC/B,QAAkC;IAElC,MAAM,IAAI,GAAG,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;IAEjC,wEAAwE;IACxE,MAAM,UAAU,GAAG,IAAI,CAAC,MAAM,CAC5B,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,CAAC,QAAQ,CAAC,GAAG,CAAC,IAAI,CAAC,aAAa,CAAC,GAAG,CAAC,GAAG,CAAC,CACtD,CAAC;IACF,IAAI,UAAU,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAC1B,OAAO,UAAU,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC;YAC9B,KAAK,EAAE,cAAc,CAAC,GAAG,CAAC;YAC1B,IAAI,EAAE,YAAY,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;SAChC,CAAC,CAAC,CAAC;IACN,CAAC;IAED,oDAAoD;IACpD,IAAI,QAAQ,EAAE,MAAM,IAAI,QAAQ,CAAC,MAAM,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACnD,MAAM,QAAQ,GAAmB,EAAE,CAAC;QACpC,KAAK,MAAM,EAAE,KAAK,EAAE,IAAI,QAAQ,CAAC,MAAM,EAAE,CAAC;YACxC,2EAA2E;YAC3E,MAAM,QAAQ,GAAG,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;YACpC,MAAM,GAAG,GAAG,QAAQ,IAAI,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,KAAK,CAAC,QAAQ,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC;YAC9D,IAAI,GAAG,IAAI,MAAM,EAAE,CAAC;gBAClB,QAAQ,CAAC,IAAI,CAAC;oBACZ,KAAK,EAAE,cAAc,CAAC,KAAK,CAAC;oBAC5B,IAAI,EAAE,YAAY,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;iBAChC,CAAC,CAAC;YACL,CAAC;QACH,CAAC;QACD,OAAO,QAAQ,CAAC;IAClB,CAAC;IAED,wEAAwE;IACxE,OAAO,IAAI;SACR,MAAM,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC,aAAa,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;SACxC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC;QACb,KAAK,EAAE,cAAc,CAAC,GAAG,MAAM,IAAI,GAAG,EAAE,CAAC;QACzC,IAAI,EAAE,YAAY,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;KAChC,CAAC,CAAC,CAAC;AACR,CAAC"}

package/dist/react/ConnectButton.d.ts

@@ -0,0 +1,27 @@
+import type { GrantPayload } from "../core/types.js";
+/** Props for the {@link ConnectButton} component. */
+export interface ConnectButtonProps {
+    /** Session ID from the server-side `connect()` call. */
+    sessionId: string;
+    /** URL to account.vana.org/connect. */
+    connectUrl?: string;
+    /** Called when the user approves the grant. */
+    onComplete?: (grant: GrantPayload) => void;
+    /** Called on polling errors. */
+    onError?: (error: string) => void;
+    /** Called when the user denies the request. */
+    onDenied?: (reason: string) => void;
+    /** CSS class name for the wrapper element. */
+    className?: string;
+    /** Label for the connect anchor (default: `"Connect with Vana"`). */
+    label?: string;
+}
+/**
+ * Pre-built React component that displays connection status and a deep link.
+ *
+ * For full control over the UI, use {@link useVanaConnect} or {@link useVanaData} directly.
+ *
+ * @param props - Component props.
+ */
+export declare function ConnectButton(props: ConnectButtonProps): import("react/jsx-runtime").JSX.Element;
+//# sourceMappingURL=ConnectButton.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"ConnectButton.d.ts","sourceRoot":"","sources":["../../src/react/ConnectButton.tsx"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AAGrD,qDAAqD;AACrD,MAAM,WAAW,kBAAkB;IACjC,wDAAwD;IACxD,SAAS,EAAE,MAAM,CAAC;IAClB,uCAAuC;IACvC,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,+CAA+C;IAC/C,UAAU,CAAC,EAAE,CAAC,KAAK,EAAE,YAAY,KAAK,IAAI,CAAC;IAC3C,gCAAgC;IAChC,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;IAClC,+CAA+C;IAC/C,QAAQ,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,IAAI,CAAC;IACpC,8CAA8C;IAC9C,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,qEAAqE;IACrE,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED;;;;;;GAMG;AACH,wBAAgB,aAAa,CAAC,KAAK,EAAE,kBAAkB,2CAiDtD"}

package/dist/react/ConnectButton.js

@@ -0,0 +1,39 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { useEffect } from "react";
+import { useVanaConnect } from "./useVanaConnect.js";
+/**
+ * Pre-built React component that displays connection status and a deep link.
+ *
+ * For full control over the UI, use {@link useVanaConnect} or {@link useVanaData} directly.
+ *
+ * @param props - Component props.
+ */
+export function ConnectButton(props) {
+    const { sessionId, connectUrl: connectUrlProp, onComplete, onError, onDenied, className, label, } = props;
+    const { connect, status, grant, error, connectUrl } = useVanaConnect();
+    useEffect(() => {
+        connect({ sessionId, connectUrl: connectUrlProp });
+    }, [sessionId, connectUrlProp, connect]);
+    useEffect(() => {
+        if (status === "approved" && grant && onComplete) {
+            onComplete(grant);
+        }
+        if (status === "error" && error && onError) {
+            onError(error);
+        }
+        if (status === "denied" && onDenied) {
+            onDenied(error ?? "User denied the request");
+        }
+    }, [status, grant, error, onComplete, onError, onDenied]);
+    const statusText = {
+        idle: "Initializing...",
+        connecting: "Connecting...",
+        waiting: "Waiting for approval...",
+        approved: "Connected!",
+        denied: "Request denied",
+        expired: "Session expired",
+        error: "Connection error",
+    };
+    return (_jsxs("div", { className: className, children: [_jsx("p", { children: statusText[status] ?? status }), connectUrl && status === "waiting" && (_jsx("a", { href: connectUrl, target: "_blank", rel: "noopener noreferrer", children: label ?? "Connect with Vana" }))] }));
+}
+//# sourceMappingURL=ConnectButton.js.map

package/dist/react/ConnectButton.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ConnectButton.js","sourceRoot":"","sources":["../../src/react/ConnectButton.tsx"],"names":[],"mappings":";AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AAElC,OAAO,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAoBrD;;;;;;GAMG;AACH,MAAM,UAAU,aAAa,CAAC,KAAyB;IACrD,MAAM,EACJ,SAAS,EACT,UAAU,EAAE,cAAc,EAC1B,UAAU,EACV,OAAO,EACP,QAAQ,EACR,SAAS,EACT,KAAK,GACN,GAAG,KAAK,CAAC;IAEV,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,KAAK,EAAE,UAAU,EAAE,GAAG,cAAc,EAAE,CAAC;IAEvE,SAAS,CAAC,GAAG,EAAE;QACb,OAAO,CAAC,EAAE,SAAS,EAAE,UAAU,EAAE,cAAc,EAAE,CAAC,CAAC;IACrD,CAAC,EAAE,CAAC,SAAS,EAAE,cAAc,EAAE,OAAO,CAAC,CAAC,CAAC;IAEzC,SAAS,CAAC,GAAG,EAAE;QACb,IAAI,MAAM,KAAK,UAAU,IAAI,KAAK,IAAI,UAAU,EAAE,CAAC;YACjD,UAAU,CAAC,KAAK,CAAC,CAAC;QACpB,CAAC;QACD,IAAI,MAAM,KAAK,OAAO,IAAI,KAAK,IAAI,OAAO,EAAE,CAAC;YAC3C,OAAO,CAAC,KAAK,CAAC,CAAC;QACjB,CAAC;QACD,IAAI,MAAM,KAAK,QAAQ,IAAI,QAAQ,EAAE,CAAC;YACpC,QAAQ,CAAC,KAAK,IAAI,yBAAyB,CAAC,CAAC;QAC/C,CAAC;IACH,CAAC,EAAE,CAAC,MAAM,EAAE,KAAK,EAAE,KAAK,EAAE,UAAU,EAAE,OAAO,EAAE,QAAQ,CAAC,CAAC,CAAC;IAE1D,MAAM,UAAU,GAA2B;QACzC,IAAI,EAAE,iBAAiB;QACvB,UAAU,EAAE,eAAe;QAC3B,OAAO,EAAE,yBAAyB;QAClC,QAAQ,EAAE,YAAY;QACtB,MAAM,EAAE,gBAAgB;QACxB,OAAO,EAAE,iBAAiB;QAC1B,KAAK,EAAE,kBAAkB;KAC1B,CAAC;IAEF,OAAO,CACL,eAAK,SAAS,EAAE,SAAS,aACvB,sBAAI,UAAU,CAAC,MAAM,CAAC,IAAI,MAAM,GAAK,EACpC,UAAU,IAAI,MAAM,KAAK,SAAS,IAAI,CACrC,YAAG,IAAI,EAAE,UAAU,EAAE,MAAM,EAAC,QAAQ,EAAC,GAAG,EAAC,qBAAqB,YAC3D,KAAK,IAAI,mBAAmB,GAC3B,CACL,IACG,CACP,CAAC;AACJ,CAAC"}

package/dist/react/index.d.ts

@@ -0,0 +1,4 @@
+export { useVanaConnect, type UseVanaConnectConfig, type UseVanaConnectResult, } from "./useVanaConnect.js";
+export { ConnectButton, type ConnectButtonProps } from "./ConnectButton.js";
+export { useVanaData, type UseVanaDataConfig, type UseVanaDataResult, } from "./useVanaData.js";
+//# 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,OAAO,EACL,cAAc,EACd,KAAK,oBAAoB,EACzB,KAAK,oBAAoB,GAC1B,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EAAE,aAAa,EAAE,KAAK,kBAAkB,EAAE,MAAM,oBAAoB,CAAC;AAC5E,OAAO,EACL,WAAW,EACX,KAAK,iBAAiB,EACtB,KAAK,iBAAiB,GACvB,MAAM,kBAAkB,CAAC"}

package/dist/react/index.js

@@ -0,0 +1,4 @@
+export { useVanaConnect, } from "./useVanaConnect.js";
+export { ConnectButton } from "./ConnectButton.js";
+export { useVanaData, } from "./useVanaData.js";
+//# 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":"AAAA,OAAO,EACL,cAAc,GAGf,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EAAE,aAAa,EAA2B,MAAM,oBAAoB,CAAC;AAC5E,OAAO,EACL,WAAW,GAGZ,MAAM,kBAAkB,CAAC"}

package/dist/react/useVanaConnect.d.ts

@@ -0,0 +1,50 @@
+import type { ConnectionStatus, GrantPayload } from "../core/types.js";
+/** Configuration for the {@link useVanaConnect} hook. */
+export interface UseVanaConnectConfig {
+    /** Polling interval in milliseconds (default: 2000). */
+    pollingInterval?: number;
+    /** SDK environment (`"dev"` or `"prod"`). Defaults to `"prod"`. */
+    environment?: "dev" | "prod";
+}
+/** Return value of the {@link useVanaConnect} hook. */
+export interface UseVanaConnectResult {
+    /** Starts polling the Session Relay for the given session. */
+    connect: (params: {
+        sessionId: string;
+        connectUrl?: string;
+    }) => void;
+    /** Current connection status. */
+    status: ConnectionStatus;
+    /** Grant payload after user approval, or `null`. */
+    grant: GrantPayload | null;
+    /** Error message, or `null`. */
+    error: string | null;
+    /** URL to account.vana.org where the user signs in and launches Data Connect, or `null`. */
+    connectUrl: string | null;
+    /** Resets all state back to idle and stops polling. */
+    reset: () => void;
+}
+/**
+ * React hook that polls the Session Relay and manages connection state.
+ *
+ * Call `connect()` with a session ID (from your server's `/api/connect` route)
+ * to begin polling. The hook will update `status` through the lifecycle:
+ * `idle` -> `connecting` -> `waiting` -> `approved` | `denied` | `expired` | `error`.
+ *
+ * @param config - Optional configuration for polling interval and environment.
+ * @returns A {@link UseVanaConnectResult} with state and actions.
+ *
+ * @example
+ * ```tsx
+ * const { connect, status, grant, connectUrl } = useVanaConnect();
+ *
+ * useEffect(() => {
+ *   connect({ sessionId: "sess-123" });
+ * }, []);
+ *
+ * if (status === "waiting") return <a href={connectUrl!}>Open Vana</a>;
+ * if (status === "approved") return <p>Connected! Grant: {grant!.grantId}</p>;
+ * ```
+ */
+export declare function useVanaConnect(config?: UseVanaConnectConfig): UseVanaConnectResult;
+//# sourceMappingURL=useVanaConnect.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"useVanaConnect.d.ts","sourceRoot":"","sources":["../../src/react/useVanaConnect.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EACV,gBAAgB,EAChB,YAAY,EAEb,MAAM,kBAAkB,CAAC;AAE1B,yDAAyD;AACzD,MAAM,WAAW,oBAAoB;IACnC,wDAAwD;IACxD,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,mEAAmE;IACnE,WAAW,CAAC,EAAE,KAAK,GAAG,MAAM,CAAC;CAC9B;AAED,uDAAuD;AACvD,MAAM,WAAW,oBAAoB;IACnC,8DAA8D;IAC9D,OAAO,EAAE,CAAC,MAAM,EAAE;QAAE,SAAS,EAAE,MAAM,CAAC;QAAC,UAAU,CAAC,EAAE,MAAM,CAAA;KAAE,KAAK,IAAI,CAAC;IACtE,iCAAiC;IACjC,MAAM,EAAE,gBAAgB,CAAC;IACzB,oDAAoD;IACpD,KAAK,EAAE,YAAY,GAAG,IAAI,CAAC;IAC3B,gCAAgC;IAChC,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IACrB,4FAA4F;IAC5F,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,uDAAuD;IACvD,KAAK,EAAE,MAAM,IAAI,CAAC;CACnB;AAED;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,wBAAgB,cAAc,CAC5B,MAAM,CAAC,EAAE,oBAAoB,GAC5B,oBAAoB,CA0GtB"}

package/dist/react/useVanaConnect.js

@@ -0,0 +1,114 @@
+import { useState, useCallback, useRef, useEffect } from "react";
+import { getEnvConfig } from "../core/constants.js";
+/**
+ * React hook that polls the Session Relay and manages connection state.
+ *
+ * Call `connect()` with a session ID (from your server's `/api/connect` route)
+ * to begin polling. The hook will update `status` through the lifecycle:
+ * `idle` -> `connecting` -> `waiting` -> `approved` | `denied` | `expired` | `error`.
+ *
+ * @param config - Optional configuration for polling interval and environment.
+ * @returns A {@link UseVanaConnectResult} with state and actions.
+ *
+ * @example
+ * ```tsx
+ * const { connect, status, grant, connectUrl } = useVanaConnect();
+ *
+ * useEffect(() => {
+ *   connect({ sessionId: "sess-123" });
+ * }, []);
+ *
+ * if (status === "waiting") return <a href={connectUrl!}>Open Vana</a>;
+ * if (status === "approved") return <p>Connected! Grant: {grant!.grantId}</p>;
+ * ```
+ */
+export function useVanaConnect(config) {
+    const envConfig = getEnvConfig(config?.environment);
+    const baseUrl = envConfig.sessionRelayUrl;
+    const accountUrl = envConfig.accountUrl;
+    const interval = config?.pollingInterval ?? 2000;
+    const [status, setStatus] = useState("idle");
+    const [grant, setGrant] = useState(null);
+    const [error, setError] = useState(null);
+    const [connectUrl, setConnectUrl] = useState(null);
+    const timerRef = useRef(null);
+    const stopPolling = useCallback(() => {
+        if (timerRef.current !== null) {
+            clearInterval(timerRef.current);
+            timerRef.current = null;
+        }
+    }, []);
+    const reset = useCallback(() => {
+        stopPolling();
+        setStatus("idle");
+        setGrant(null);
+        setError(null);
+        setConnectUrl(null);
+    }, [stopPolling]);
+    const connect = useCallback((params) => {
+        stopPolling();
+        setStatus("connecting");
+        setGrant(null);
+        setError(null);
+        setConnectUrl(params.connectUrl ??
+            `${accountUrl}/connect?sessionId=${params.sessionId}`);
+        const pollUrl = `${baseUrl}/v1/session/${params.sessionId}/poll`;
+        const poll = async () => {
+            try {
+                const res = await fetch(pollUrl);
+                if (!res.ok) {
+                    // Try to extract structured error from response body
+                    const body = await res.json().catch(() => null);
+                    const errorCode = body && typeof body === "object"
+                        ? body.error
+                            ?.errorCode
+                        : undefined;
+                    if (res.status === 410 || errorCode === "SESSION_EXPIRED") {
+                        setStatus("expired");
+                        setError("Session expired");
+                    }
+                    else {
+                        setStatus("error");
+                        setError(`Poll failed: ${res.status}`);
+                    }
+                    stopPolling();
+                    return;
+                }
+                const result = (await res.json());
+                switch (result.status) {
+                    case "pending":
+                    case "claimed":
+                        setStatus("waiting");
+                        break;
+                    case "approved":
+                        setStatus("approved");
+                        setGrant(result.grant ?? null);
+                        stopPolling();
+                        break;
+                    case "denied":
+                        setStatus("denied");
+                        setError(result.reason ?? "User denied the request");
+                        stopPolling();
+                        break;
+                    case "expired":
+                        setStatus("expired");
+                        setError("Session expired");
+                        stopPolling();
+                        break;
+                }
+            }
+            catch (err) {
+                setStatus("error");
+                setError(err instanceof Error ? err.message : "Unknown polling error");
+                stopPolling();
+            }
+        };
+        // First poll immediately, then at interval
+        void poll();
+        timerRef.current = setInterval(() => void poll(), interval);
+    }, [baseUrl, accountUrl, interval, stopPolling]);
+    // Cleanup on unmount
+    useEffect(() => stopPolling, [stopPolling]);
+    return { connect, status, grant, error, connectUrl, reset };
+}
+//# sourceMappingURL=useVanaConnect.js.map

package/dist/react/useVanaConnect.js.map

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

package/dist/react/useVanaData.d.ts

@@ -0,0 +1,69 @@
+import type { ConnectionStatus, GrantPayload } from "../core/types.js";
+/**
+ * Configuration for the {@link useVanaData} hook.
+ */
+export interface UseVanaDataConfig {
+    /** URL of the connect API route (default: `"/api/connect"`). */
+    connectUrl?: string;
+    /** URL of the data API route (default: `"/api/data"`). */
+    dataUrl?: string;
+    /** Polling interval in ms passed to {@link useVanaConnect} (default: 2000). */
+    pollingInterval?: number;
+    /** SDK environment passed through to {@link useVanaConnect}. */
+    environment?: "dev" | "prod";
+    /** When true, automatically fetches data after grant approval (default: `true`). */
+    autoFetch?: boolean;
+}
+/**
+ * Return value of the {@link useVanaData} hook.
+ */
+export interface UseVanaDataResult {
+    /** Current connection status. */
+    status: ConnectionStatus;
+    /** Grant payload after user approval, or `null`. */
+    grant: GrantPayload | null;
+    /** Fetched data after calling the data route, or `null`. */
+    data: unknown;
+    /** Error message, or `null`. */
+    error: string | null;
+    /** URL to account.vana.org where the user signs in and launches Data Connect, or `null`. */
+    connectUrl: string | null;
+    /** Opens the connect URL in a new tab. Use this instead of rendering the URL directly to avoid navigating away from your app. */
+    openConnect: () => void;
+    /** Starts the connect flow by calling the connect API route. */
+    initConnect: () => Promise<void>;
+    /** Manually fetches data using the current grant. */
+    fetchData: () => Promise<void>;
+    /** Resets all state back to idle. */
+    reset: () => void;
+    /** `true` while any async operation is in progress. */
+    isLoading: boolean;
+    /** `true` when status is `"approved"`. */
+    isConnected: boolean;
+}
+/**
+ * Full-flow hook that orchestrates the entire Vana Connect lifecycle:
+ * session init, polling, and data fetching.
+ *
+ * Composes {@link useVanaConnect} internally and adds automatic
+ * calls to your app's `/api/connect` and `/api/data` routes.
+ *
+ * @param config - Optional configuration.
+ * @returns A {@link UseVanaDataResult} with state and actions.
+ *
+ * @example
+ * ```tsx
+ * import { useVanaData } from "vana-cli/react";
+ *
+ * function MyComponent() {
+ *   const { status, data, deepLinkUrl, initConnect, isLoading } = useVanaData();
+ *
+ *   if (status === "idle") return <button onClick={initConnect}>Connect</button>;
+ *   if (status === "waiting") return <a href={deepLinkUrl!}>Open Vana</a>;
+ *   if (data) return <pre>{JSON.stringify(data, null, 2)}</pre>;
+ *   return <p>{isLoading ? "Loading..." : status}</p>;
+ * }
+ * ```
+ */
+export declare function useVanaData(config?: UseVanaDataConfig): UseVanaDataResult;
+//# sourceMappingURL=useVanaData.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"useVanaData.d.ts","sourceRoot":"","sources":["../../src/react/useVanaData.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,gBAAgB,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AAevE;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,gEAAgE;IAChE,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,0DAA0D;IAC1D,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,+EAA+E;IAC/E,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,gEAAgE;IAChE,WAAW,CAAC,EAAE,KAAK,GAAG,MAAM,CAAC;IAC7B,oFAAoF;IACpF,SAAS,CAAC,EAAE,OAAO,CAAC;CACrB;AAED;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,iCAAiC;IACjC,MAAM,EAAE,gBAAgB,CAAC;IACzB,oDAAoD;IACpD,KAAK,EAAE,YAAY,GAAG,IAAI,CAAC;IAC3B,4DAA4D;IAC5D,IAAI,EAAE,OAAO,CAAC;IACd,gCAAgC;IAChC,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IACrB,4FAA4F;IAC5F,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,iIAAiI;IACjI,WAAW,EAAE,MAAM,IAAI,CAAC;IACxB,gEAAgE;IAChE,WAAW,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;IACjC,qDAAqD;IACrD,SAAS,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;IAC/B,qCAAqC;IACrC,KAAK,EAAE,MAAM,IAAI,CAAC;IAClB,uDAAuD;IACvD,SAAS,EAAE,OAAO,CAAC;IACnB,0CAA0C;IAC1C,WAAW,EAAE,OAAO,CAAC;CACtB;AAED;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,wBAAgB,WAAW,CAAC,MAAM,CAAC,EAAE,iBAAiB,GAAG,iBAAiB,CA8HzE"}