@opendatalabs/connect 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 OpenDataLabs
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,81 @@
+# @opendatalabs/connect
+
+SDK for integrating Vana Data Portability "Connect data" flows into builder applications.
+
+## Installation
+
+```bash
+npm install @opendatalabs/connect
+```
+
+## Entrypoints
+
+| Entrypoint                     | Environment | Description                                |
+| ------------------------------ | ----------- | ------------------------------------------ |
+| `@opendatalabs/connect/server` | Node.js     | Session relay, request signer, data client |
+| `@opendatalabs/connect/react`  | Browser     | Polling hook, connect button               |
+| `@opendatalabs/connect/core`   | Universal   | Shared types and errors                    |
+
+## Quick Start (Server)
+
+```typescript
+import {
+  createSessionRelay,
+  createDataClient,
+} from "@opendatalabs/connect/server";
+
+// Create a session for your user
+const relay = createSessionRelay({
+  privateKey: process.env.VANA_APP_PRIVATE_KEY,
+  granteeAddress: "0x...",
+  sessionRelayUrl: "https://session-relay.vana.org",
+});
+const session = await relay.initSession({
+  scopes: ["instagram.profile"],
+});
+
+// Poll until user approves in Desktop App
+const result = await relay.pollUntilComplete(session.sessionId);
+
+// Fetch user data with the grant
+const data = createDataClient({
+  privateKey: process.env.VANA_APP_PRIVATE_KEY,
+  gatewayUrl: "https://gateway.vana.org",
+});
+const serverUrl = await data.resolveServerUrl(result.grant.userAddress);
+const profile = await data.fetchData({
+  serverUrl,
+  scope: "instagram.profile",
+  grantId: result.grant.grantId,
+});
+```
+
+## Quick Start (React)
+
+```tsx
+import { useVanaConnect } from "@opendatalabs/connect/react";
+
+function ConnectPage({ sessionId }: { sessionId: string }) {
+  const { connect, status, grant, deepLinkUrl } = useVanaConnect({
+    sessionRelayUrl: "https://session-relay.vana.org",
+  });
+
+  useEffect(() => {
+    connect({ sessionId });
+  }, [sessionId]);
+
+  if (status === "waiting" && deepLinkUrl) {
+    return <a href={deepLinkUrl}>Open Vana Desktop App</a>;
+  }
+
+  if (status === "approved" && grant) {
+    return <p>Connected! Grant: {grant.grantId}</p>;
+  }
+
+  return <p>Status: {status}</p>;
+}
+```
+
+## License
+
+MIT

package/dist/core/errors.d.ts

@@ -0,0 +1,6 @@
+export declare class ConnectError extends Error {
+    readonly code: string;
+    readonly statusCode?: number;
+    constructor(message: string, code: string, statusCode?: number);
+}
+//# sourceMappingURL=errors.d.ts.map

package/dist/core/errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../src/core/errors.ts"],"names":[],"mappings":"AAAA,qBAAa,YAAa,SAAQ,KAAK;IACrC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;gBAEjB,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE,MAAM;CAM/D"}

package/dist/core/errors.js

@@ -0,0 +1,11 @@
+export class ConnectError extends Error {
+    code;
+    statusCode;
+    constructor(message, code, statusCode) {
+        super(message);
+        this.name = "ConnectError";
+        this.code = code;
+        this.statusCode = statusCode;
+    }
+}
+//# sourceMappingURL=errors.js.map

package/dist/core/errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../../src/core/errors.ts"],"names":[],"mappings":"AAAA,MAAM,OAAO,YAAa,SAAQ,KAAK;IAC5B,IAAI,CAAS;IACb,UAAU,CAAU;IAE7B,YAAY,OAAe,EAAE,IAAY,EAAE,UAAmB;QAC5D,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,cAAc,CAAC;QAC3B,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;QACjB,IAAI,CAAC,UAAU,GAAG,UAAU,CAAC;IAC/B,CAAC;CACF"}

package/dist/core/index.d.ts

@@ -0,0 +1,3 @@
+export { ConnectError } from "./errors.js";
+export type { ConnectionStatus, SessionInitParams, SessionInitResult, SessionPollResult, GrantPayload, DataFetchParams, RequestSignerConfig, SessionRelayConfig, DataClientConfig, } from "./types.js";
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/core/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAC3C,YAAY,EACV,gBAAgB,EAChB,iBAAiB,EACjB,iBAAiB,EACjB,iBAAiB,EACjB,YAAY,EACZ,eAAe,EACf,mBAAmB,EACnB,kBAAkB,EAClB,gBAAgB,GACjB,MAAM,YAAY,CAAC"}

package/dist/core/index.js

@@ -0,0 +1,2 @@
+export { ConnectError } from "./errors.js";
+//# sourceMappingURL=index.js.map

package/dist/core/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/core/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC"}

package/dist/core/types.d.ts

@@ -0,0 +1,43 @@
+export type ConnectionStatus = "idle" | "connecting" | "waiting" | "approved" | "denied" | "expired" | "error";
+export interface SessionInitParams {
+    scopes: string[];
+    webhookUrl?: string;
+    appUserId?: string;
+}
+export interface SessionInitResult {
+    sessionId: string;
+    deepLinkUrl: string;
+    expiresAt: string;
+}
+export interface SessionPollResult {
+    status: "pending" | "claimed" | "approved" | "denied" | "expired";
+    grant?: GrantPayload;
+    reason?: string;
+}
+export interface GrantPayload {
+    grantId: string;
+    userAddress: string;
+    builderAddress: string;
+    scopes: string[];
+    appUserId?: string;
+}
+export interface DataFetchParams {
+    serverUrl: string;
+    scope: string;
+    grantId: string;
+    fileId?: string;
+    at?: string;
+}
+export interface RequestSignerConfig {
+    privateKey: `0x${string}`;
+}
+export interface SessionRelayConfig {
+    privateKey: `0x${string}`;
+    granteeAddress: `0x${string}`;
+    sessionRelayUrl: string;
+}
+export interface DataClientConfig {
+    privateKey: `0x${string}`;
+    gatewayUrl: string;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/core/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/core/types.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,gBAAgB,GACxB,MAAM,GACN,YAAY,GACZ,SAAS,GACT,UAAU,GACV,QAAQ,GACR,SAAS,GACT,OAAO,CAAC;AAEZ,MAAM,WAAW,iBAAiB;IAChC,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,iBAAiB;IAChC,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,iBAAiB;IAChC,MAAM,EAAE,SAAS,GAAG,SAAS,GAAG,UAAU,GAAG,QAAQ,GAAG,SAAS,CAAC;IAClE,KAAK,CAAC,EAAE,YAAY,CAAC;IACrB,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,YAAY;IAC3B,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,EAAE,MAAM,CAAC;IACpB,cAAc,EAAE,MAAM,CAAC;IACvB,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,eAAe;IAC9B,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,EAAE,CAAC,EAAE,MAAM,CAAC;CACb;AAED,MAAM,WAAW,mBAAmB;IAClC,UAAU,EAAE,KAAK,MAAM,EAAE,CAAC;CAC3B;AAED,MAAM,WAAW,kBAAkB;IACjC,UAAU,EAAE,KAAK,MAAM,EAAE,CAAC;IAC1B,cAAc,EAAE,KAAK,MAAM,EAAE,CAAC;IAC9B,eAAe,EAAE,MAAM,CAAC;CACzB;AAED,MAAM,WAAW,gBAAgB;IAC/B,UAAU,EAAE,KAAK,MAAM,EAAE,CAAC;IAC1B,UAAU,EAAE,MAAM,CAAC;CACpB"}

package/dist/core/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/core/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/core/types.ts"],"names":[],"mappings":""}

package/dist/index.d.ts

@@ -0,0 +1,2 @@
+export * from "./core/index.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,iBAAiB,CAAC"}

package/dist/index.js

@@ -0,0 +1,2 @@
+export * from "./core/index.js";
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,iBAAiB,CAAC"}

package/dist/react/ConnectButton.d.ts

@@ -0,0 +1,12 @@
+import type { GrantPayload } from "../core/types.js";
+export interface ConnectButtonProps {
+    sessionId: string;
+    sessionRelayUrl: string;
+    onComplete?: (grant: GrantPayload) => void;
+    onError?: (error: string) => void;
+    onDenied?: (reason: string) => void;
+    className?: string;
+    label?: string;
+}
+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,MAAM,WAAW,kBAAkB;IACjC,SAAS,EAAE,MAAM,CAAC;IAClB,eAAe,EAAE,MAAM,CAAC;IACxB,UAAU,CAAC,EAAE,CAAC,KAAK,EAAE,YAAY,KAAK,IAAI,CAAC;IAC3C,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;IAClC,QAAQ,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,IAAI,CAAC;IACpC,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,wBAAgB,aAAa,CAAC,KAAK,EAAE,kBAAkB,2CAiDtD"}

package/dist/react/ConnectButton.js

@@ -0,0 +1,34 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { useEffect } from "react";
+import { useVanaConnect } from "./useVanaConnect.js";
+export function ConnectButton(props) {
+    const { sessionId, sessionRelayUrl, onComplete, onError, onDenied, className, label, } = props;
+    const { connect, status, grant, error, deepLinkUrl } = useVanaConnect({
+        sessionRelayUrl,
+    });
+    useEffect(() => {
+        connect({ sessionId });
+    }, [sessionId, 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 }), deepLinkUrl && status === "waiting" && (_jsx("a", { href: deepLinkUrl, children: label ?? "Open Vana Desktop App" }))] }));
+}
+//# 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;AAYrD,MAAM,UAAU,aAAa,CAAC,KAAyB;IACrD,MAAM,EACJ,SAAS,EACT,eAAe,EACf,UAAU,EACV,OAAO,EACP,QAAQ,EACR,SAAS,EACT,KAAK,GACN,GAAG,KAAK,CAAC;IAEV,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,KAAK,EAAE,WAAW,EAAE,GAAG,cAAc,CAAC;QACpE,eAAe;KAChB,CAAC,CAAC;IAEH,SAAS,CAAC,GAAG,EAAE;QACb,OAAO,CAAC,EAAE,SAAS,EAAE,CAAC,CAAC;IACzB,CAAC,EAAE,CAAC,SAAS,EAAE,OAAO,CAAC,CAAC,CAAC;IAEzB,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,WAAW,IAAI,MAAM,KAAK,SAAS,IAAI,CACtC,YAAG,IAAI,EAAE,WAAW,YAAG,KAAK,IAAI,uBAAuB,GAAK,CAC7D,IACG,CACP,CAAC;AACJ,CAAC"}

package/dist/react/index.d.ts

@@ -0,0 +1,3 @@
+export { useVanaConnect, type UseVanaConnectConfig, type UseVanaConnectResult, } from "./useVanaConnect.js";
+export { ConnectButton, type ConnectButtonProps } from "./ConnectButton.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"}

package/dist/react/index.js

@@ -0,0 +1,3 @@
+export { useVanaConnect, } from "./useVanaConnect.js";
+export { ConnectButton } from "./ConnectButton.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"}

package/dist/react/useVanaConnect.d.ts

@@ -0,0 +1,17 @@
+import type { ConnectionStatus, GrantPayload } from "../core/types.js";
+export interface UseVanaConnectConfig {
+    sessionRelayUrl: string;
+    pollingInterval?: number;
+}
+export interface UseVanaConnectResult {
+    connect: (params: {
+        sessionId: string;
+    }) => void;
+    status: ConnectionStatus;
+    grant: GrantPayload | null;
+    error: string | null;
+    deepLinkUrl: string | null;
+    reset: () => void;
+}
+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":"AACA,OAAO,KAAK,EACV,gBAAgB,EAChB,YAAY,EAEb,MAAM,kBAAkB,CAAC;AAE1B,MAAM,WAAW,oBAAoB;IACnC,eAAe,EAAE,MAAM,CAAC;IACxB,eAAe,CAAC,EAAE,MAAM,CAAC;CAC1B;AAED,MAAM,WAAW,oBAAoB;IACnC,OAAO,EAAE,CAAC,MAAM,EAAE;QAAE,SAAS,EAAE,MAAM,CAAA;KAAE,KAAK,IAAI,CAAC;IACjD,MAAM,EAAE,gBAAgB,CAAC;IACzB,KAAK,EAAE,YAAY,GAAG,IAAI,CAAC;IAC3B,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IACrB,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,KAAK,EAAE,MAAM,IAAI,CAAC;CACnB;AAED,wBAAgB,cAAc,CAC5B,MAAM,EAAE,oBAAoB,GAC3B,oBAAoB,CAwFtB"}

package/dist/react/useVanaConnect.js

@@ -0,0 +1,76 @@
+import { useState, useCallback, useRef, useEffect } from "react";
+export function useVanaConnect(config) {
+    const baseUrl = config.sessionRelayUrl.replace(/\/+$/, "");
+    const interval = config.pollingInterval ?? 2000;
+    const [status, setStatus] = useState("idle");
+    const [grant, setGrant] = useState(null);
+    const [error, setError] = useState(null);
+    const [deepLinkUrl, setDeepLinkUrl] = 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);
+        setDeepLinkUrl(null);
+    }, [stopPolling]);
+    const connect = useCallback((params) => {
+        stopPolling();
+        setStatus("connecting");
+        setGrant(null);
+        setError(null);
+        setDeepLinkUrl(`vana://connect?sessionId=${params.sessionId}`);
+        const pollUrl = `${baseUrl}/v1/session/${params.sessionId}/poll`;
+        const poll = async () => {
+            try {
+                const res = await fetch(pollUrl);
+                if (!res.ok) {
+                    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, interval, stopPolling]);
+    // Cleanup on unmount
+    useEffect(() => stopPolling, [stopPolling]);
+    return { connect, status, grant, error, deepLinkUrl, 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/server/data-client.d.ts

@@ -0,0 +1,14 @@
+import type { DataClientConfig, DataFetchParams } from "../core/types.js";
+export interface DataClient {
+    resolveServerUrl(userAddress: string): Promise<string>;
+    fetchData(params: DataFetchParams): Promise<unknown>;
+    listScopes(params: {
+        serverUrl: string;
+    }): Promise<unknown>;
+    listVersions(params: {
+        serverUrl: string;
+        scope: string;
+    }): Promise<unknown>;
+}
+export declare function createDataClient(config: DataClientConfig): DataClient;
+//# sourceMappingURL=data-client.d.ts.map

package/dist/server/data-client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"data-client.d.ts","sourceRoot":"","sources":["../../src/server/data-client.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,gBAAgB,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAC;AAG1E,MAAM,WAAW,UAAU;IACzB,gBAAgB,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;IACvD,SAAS,CAAC,MAAM,EAAE,eAAe,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IACrD,UAAU,CAAC,MAAM,EAAE;QAAE,SAAS,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IAC5D,YAAY,CAAC,MAAM,EAAE;QAAE,SAAS,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;CAC9E;AAED,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,gBAAgB,GAAG,UAAU,CAiHrE"}

package/dist/server/data-client.js

@@ -0,0 +1,75 @@
+import { ConnectError } from "../core/errors.js";
+import { createRequestSigner } from "./request-signer.js";
+export function createDataClient(config) {
+    const gatewayBase = config.gatewayUrl.replace(/\/+$/, "");
+    const signer = createRequestSigner({ privateKey: config.privateKey });
+    return {
+        async resolveServerUrl(userAddress) {
+            const res = await fetch(`${gatewayBase}/v1/servers/${userAddress}`);
+            if (res.status === 404) {
+                throw new ConnectError(`No server registered for ${userAddress}`, "SERVER_NOT_FOUND", 404);
+            }
+            if (!res.ok) {
+                throw new ConnectError(`Gateway error: ${res.status}`, "GATEWAY_ERROR", res.status);
+            }
+            const envelope = (await res.json());
+            return envelope.data.serverUrl;
+        },
+        async fetchData(params) {
+            const base = params.serverUrl.replace(/\/+$/, "");
+            const queryParams = new URLSearchParams();
+            if (params.fileId)
+                queryParams.set("fileId", params.fileId);
+            if (params.at)
+                queryParams.set("at", params.at);
+            const qs = queryParams.toString();
+            const uri = `/v1/data/${params.scope}${qs ? `?${qs}` : ""}`;
+            const authHeader = await signer.signRequest({
+                aud: base,
+                method: "GET",
+                uri,
+                grantId: params.grantId,
+            });
+            const res = await fetch(`${base}${uri}`, {
+                headers: { Authorization: authHeader },
+            });
+            if (!res.ok) {
+                throw new ConnectError(`Data fetch failed: ${res.status}`, "DATA_FETCH_FAILED", res.status);
+            }
+            return res.json();
+        },
+        async listScopes(params) {
+            const base = params.serverUrl.replace(/\/+$/, "");
+            const uri = "/v1/data";
+            const authHeader = await signer.signRequest({
+                aud: base,
+                method: "GET",
+                uri,
+            });
+            const res = await fetch(`${base}${uri}`, {
+                headers: { Authorization: authHeader },
+            });
+            if (!res.ok) {
+                throw new ConnectError(`List scopes failed: ${res.status}`, "LIST_SCOPES_FAILED", res.status);
+            }
+            return res.json();
+        },
+        async listVersions(params) {
+            const base = params.serverUrl.replace(/\/+$/, "");
+            const uri = `/v1/data/${params.scope}/versions`;
+            const authHeader = await signer.signRequest({
+                aud: base,
+                method: "GET",
+                uri,
+            });
+            const res = await fetch(`${base}${uri}`, {
+                headers: { Authorization: authHeader },
+            });
+            if (!res.ok) {
+                throw new ConnectError(`List versions failed: ${res.status}`, "LIST_VERSIONS_FAILED", res.status);
+            }
+            return res.json();
+        },
+    };
+}
+//# sourceMappingURL=data-client.js.map

package/dist/server/data-client.js.map

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

package/dist/server/index.d.ts

@@ -0,0 +1,4 @@
+export { createRequestSigner, type RequestSigner } from "./request-signer.js";
+export { createSessionRelay, type SessionRelay } from "./session-relay.js";
+export { createDataClient, type DataClient } from "./data-client.js";
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/server/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,mBAAmB,EAAE,KAAK,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAC9E,OAAO,EAAE,kBAAkB,EAAE,KAAK,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAC3E,OAAO,EAAE,gBAAgB,EAAE,KAAK,UAAU,EAAE,MAAM,kBAAkB,CAAC"}

package/dist/server/index.js

@@ -0,0 +1,4 @@
+export { createRequestSigner } from "./request-signer.js";
+export { createSessionRelay } from "./session-relay.js";
+export { createDataClient } from "./data-client.js";
+//# sourceMappingURL=index.js.map

package/dist/server/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/server/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,mBAAmB,EAAsB,MAAM,qBAAqB,CAAC;AAC9E,OAAO,EAAE,kBAAkB,EAAqB,MAAM,oBAAoB,CAAC;AAC3E,OAAO,EAAE,gBAAgB,EAAmB,MAAM,kBAAkB,CAAC"}

package/dist/server/request-signer.d.ts

@@ -0,0 +1,13 @@
+import type { RequestSignerConfig } from "../core/types.js";
+export interface RequestSigner {
+    signRequest(params: {
+        aud: string;
+        method: string;
+        uri: string;
+        body?: string;
+        grantId?: string;
+    }): Promise<string>;
+    readonly address: `0x${string}`;
+}
+export declare function createRequestSigner(config: RequestSignerConfig): RequestSigner;
+//# sourceMappingURL=request-signer.d.ts.map

package/dist/server/request-signer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"request-signer.d.ts","sourceRoot":"","sources":["../../src/server/request-signer.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,kBAAkB,CAAC;AA+B5D,MAAM,WAAW,aAAa;IAC5B,WAAW,CAAC,MAAM,EAAE;QAClB,GAAG,EAAE,MAAM,CAAC;QACZ,MAAM,EAAE,MAAM,CAAC;QACf,GAAG,EAAE,MAAM,CAAC;QACZ,IAAI,CAAC,EAAE,MAAM,CAAC;QACd,OAAO,CAAC,EAAE,MAAM,CAAC;KAClB,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;IACpB,QAAQ,CAAC,OAAO,EAAE,KAAK,MAAM,EAAE,CAAC;CACjC;AAED,wBAAgB,mBAAmB,CACjC,MAAM,EAAE,mBAAmB,GAC1B,aAAa,CAsCf"}

package/dist/server/request-signer.js

@@ -0,0 +1,63 @@
+import { createHash } from "node:crypto";
+import { privateKeyToAccount } from "viem/accounts";
+function base64urlEncode(input) {
+    return Buffer.from(input, "utf-8")
+        .toString("base64")
+        .replace(/\+/g, "-")
+        .replace(/\//g, "_")
+        .replace(/=+$/, "");
+}
+function canonicalizeJson(obj) {
+    if (obj === null || typeof obj !== "object")
+        return obj;
+    if (Array.isArray(obj))
+        return obj.map(canonicalizeJson);
+    const sorted = {};
+    for (const key of Object.keys(obj).sort()) {
+        if (key === "signature")
+            continue;
+        sorted[key] = canonicalizeJson(obj[key]);
+    }
+    return sorted;
+}
+function computeBodyHash(body) {
+    if (!body || body.length === 0) {
+        return "sha256:e3b0c44298fc1c149afbf4c8996fb92427ae41e4649b934ca495991b7852b855";
+    }
+    const parsed = JSON.parse(body);
+    const canonical = canonicalizeJson(parsed);
+    const canonicalStr = JSON.stringify(canonical);
+    return `sha256:${createHash("sha256").update(canonicalStr).digest("hex")}`;
+}
+export function createRequestSigner(config) {
+    const account = privateKeyToAccount(config.privateKey);
+    return {
+        address: account.address,
+        async signRequest(params) {
+            const now = Math.floor(Date.now() / 1000);
+            const payload = {
+                aud: params.aud,
+                bodyHash: computeBodyHash(params.body),
+                exp: now + 300,
+                iat: now,
+                method: params.method,
+                uri: params.uri,
+            };
+            if (params.grantId !== undefined) {
+                payload["grantId"] = params.grantId;
+            }
+            // Sort keys for deterministic serialization
+            const sortedPayload = Object.keys(payload)
+                .sort()
+                .reduce((acc, key) => {
+                acc[key] = payload[key];
+                return acc;
+            }, {});
+            const payloadJson = JSON.stringify(sortedPayload);
+            const payloadBase64 = base64urlEncode(payloadJson);
+            const signature = await account.signMessage({ message: payloadBase64 });
+            return `Web3Signed ${payloadBase64}.${signature}`;
+        },
+    };
+}
+//# sourceMappingURL=request-signer.js.map

package/dist/server/request-signer.js.map

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

package/dist/server/session-relay.d.ts

@@ -0,0 +1,11 @@
+import type { SessionRelayConfig, SessionInitParams, SessionInitResult, SessionPollResult } from "../core/types.js";
+export interface SessionRelay {
+    initSession(params: SessionInitParams): Promise<SessionInitResult>;
+    pollSession(sessionId: string): Promise<SessionPollResult>;
+    pollUntilComplete(sessionId: string, opts?: {
+        interval?: number;
+        timeout?: number;
+    }): Promise<SessionPollResult>;
+}
+export declare function createSessionRelay(config: SessionRelayConfig): SessionRelay;
+//# sourceMappingURL=session-relay.d.ts.map

package/dist/server/session-relay.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"session-relay.d.ts","sourceRoot":"","sources":["../../src/server/session-relay.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EACV,kBAAkB,EAClB,iBAAiB,EACjB,iBAAiB,EACjB,iBAAiB,EAClB,MAAM,kBAAkB,CAAC;AAG1B,MAAM,WAAW,YAAY;IAC3B,WAAW,CAAC,MAAM,EAAE,iBAAiB,GAAG,OAAO,CAAC,iBAAiB,CAAC,CAAC;IACnE,WAAW,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,iBAAiB,CAAC,CAAC;IAC3D,iBAAiB,CACf,SAAS,EAAE,MAAM,EACjB,IAAI,CAAC,EAAE;QAAE,QAAQ,CAAC,EAAE,MAAM,CAAC;QAAC,OAAO,CAAC,EAAE,MAAM,CAAA;KAAE,GAC7C,OAAO,CAAC,iBAAiB,CAAC,CAAC;CAC/B;AAED,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,kBAAkB,GAAG,YAAY,CAyF3E"}

package/dist/server/session-relay.js

@@ -0,0 +1,66 @@
+import { ConnectError } from "../core/errors.js";
+import { createRequestSigner } from "./request-signer.js";
+export function createSessionRelay(config) {
+    const baseUrl = config.sessionRelayUrl.replace(/\/+$/, "");
+    const signer = createRequestSigner({ privateKey: config.privateKey });
+    return {
+        async initSession(params) {
+            const body = JSON.stringify({
+                granteeAddress: config.granteeAddress,
+                scopes: params.scopes,
+                ...(params.webhookUrl && { webhookUrl: params.webhookUrl }),
+                ...(params.appUserId && { app_user_id: params.appUserId }),
+            });
+            const authHeader = await signer.signRequest({
+                aud: baseUrl,
+                method: "POST",
+                uri: "/v1/session/init",
+                body,
+            });
+            const res = await fetch(`${baseUrl}/v1/session/init`, {
+                method: "POST",
+                headers: {
+                    "Content-Type": "application/json",
+                    Authorization: authHeader,
+                },
+                body,
+            });
+            if (!res.ok) {
+                const errorBody = await res.json().catch(() => ({}));
+                const errorMsg = errorBody.error &&
+                    typeof errorBody.error === "object"
+                    ? errorBody.error
+                        .message
+                    : `Session init failed: ${res.status}`;
+                throw new ConnectError(errorMsg, errorBody.error
+                    ?.errorCode ?? "SESSION_INIT_FAILED", res.status);
+            }
+            return (await res.json());
+        },
+        async pollSession(sessionId) {
+            const res = await fetch(`${baseUrl}/v1/session/${sessionId}/poll`);
+            if (!res.ok) {
+                const errorBody = await res.json().catch(() => ({}));
+                throw new ConnectError(`Poll failed: ${res.status}`, errorBody.error
+                    ?.errorCode ?? "POLL_FAILED", res.status);
+            }
+            return (await res.json());
+        },
+        async pollUntilComplete(sessionId, opts) {
+            const interval = opts?.interval ?? 2000;
+            const timeout = opts?.timeout ?? 900_000; // 15 minutes
+            const deadline = Date.now() + timeout;
+            while (Date.now() < deadline) {
+                const result = await this.pollSession(sessionId);
+                if (result.status === "approved" ||
+                    result.status === "denied" ||
+                    result.status === "expired") {
+                    return result;
+                }
+                await new Promise((resolve) => setTimeout(resolve, interval));
+            }
+            throw new ConnectError("Polling timed out", "POLL_TIMEOUT");
+        },
+    };
+}
+//# sourceMappingURL=session-relay.js.map

package/dist/server/session-relay.js.map

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

package/package.json

@@ -0,0 +1,100 @@
+{
+  "name": "@opendatalabs/connect",
+  "version": "0.1.0",
+  "description": "SDK for integrating Vana Data Portability 'Connect data' flows",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/vana-com/vana-connect.git"
+  },
+  "homepage": "https://github.com/vana-com/vana-connect#readme",
+  "bugs": {
+    "url": "https://github.com/vana-com/vana-connect/issues"
+  },
+  "type": "module",
+  "publishConfig": {
+    "access": "public"
+  },
+  "files": [
+    "dist"
+  ],
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    },
+    "./server": {
+      "types": "./dist/server/index.d.ts",
+      "import": "./dist/server/index.js"
+    },
+    "./react": {
+      "types": "./dist/react/index.d.ts",
+      "import": "./dist/react/index.js"
+    },
+    "./core": {
+      "types": "./dist/core/index.d.ts",
+      "import": "./dist/core/index.js"
+    }
+  },
+  "scripts": {
+    "build": "tsc --build",
+    "clean": "tsc --build --clean",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "test:e2e": "vitest run --config test/e2e/vitest.config.ts",
+    "lint": "tsc --noEmit",
+    "lint:eslint": "eslint 'src/**/*.ts' 'src/**/*.tsx'",
+    "lint:eslint:fix": "eslint --fix 'src/**/*.ts' 'src/**/*.tsx'",
+    "format": "prettier --write .",
+    "format:check": "prettier --check .",
+    "validate": "npm run lint && npm run lint:eslint && npm run format:check && npm test",
+    "prepare": "husky"
+  },
+  "lint-staged": {
+    "*.{ts,tsx,js}": [
+      "eslint --fix",
+      "prettier --write"
+    ],
+    "*.{json,md,yml,yaml}": [
+      "prettier --write"
+    ]
+  },
+  "engines": {
+    "node": ">=20.0.0"
+  },
+  "peerDependencies": {
+    "viem": "^2.0.0",
+    "react": ">=18.0.0"
+  },
+  "peerDependenciesMeta": {
+    "react": {
+      "optional": true
+    },
+    "viem": {
+      "optional": true
+    }
+  },
+  "devDependencies": {
+    "@commitlint/cli": "^20.4.1",
+    "@commitlint/config-conventional": "^20.4.1",
+    "@semantic-release/commit-analyzer": "^13.0.1",
+    "@semantic-release/git": "^10.0.1",
+    "@semantic-release/github": "^12.0.3",
+    "@semantic-release/npm": "^13.1.3",
+    "@semantic-release/release-notes-generator": "^14.1.0",
+    "@types/node": "^25.2.0",
+    "@types/react": "^19.0.0",
+    "conventional-changelog-conventionalcommits": "^9.1.0",
+    "eslint": "^9.39.2",
+    "eslint-config-prettier": "^10.1.8",
+    "husky": "^9.1.7",
+    "lint-staged": "^16.2.7",
+    "prettier": "^3.8.1",
+    "react": "^19.0.0",
+    "semantic-release": "^25.0.3",
+    "typescript": "^5.7.0",
+    "typescript-eslint": "^8.54.0",
+    "viem": "^2.45.0",
+    "vitest": "^4.0.18"
+  }
+}