@opendatalabs/connect 0.8.0 → 0.8.1-canary.1d2cf51

package/README.md

@@ -72,6 +72,80 @@ Then, in your dev version of DataConnect (likely built from the `main` branch) y
 
 If you prefer to integrate the SDK into an existing project, follow the steps below.
 
+## Headless CLI
+
+`vana-connect` now also ships a local collection CLI for connector setup and data export flows.
+
+### Install
+
+macOS and Linux:
+
+```bash
+curl -fsSL https://raw.githubusercontent.com/vana-com/vana-connect/main/install/install.sh | sh
+```
+
+Windows PowerShell:
+
+```powershell
+iwr https://raw.githubusercontent.com/vana-com/vana-connect/main/install/install.ps1 -useb | iex
+```
+
+Both installers fetch the latest GitHub release asset for your platform, verify its checksum, and install `vana` without requiring Node or npm.
+
+If you want the npm package path as a fallback:
+
+```bash
+npx -y @opendatalabs/connect status
+```
+
+### Commands
+
+```bash
+vana sources
+vana connect github
+vana status
+vana setup
+```
+
+### Local development
+
+From this repo:
+
+```bash
+pnpm install
+pnpm build
+node dist/cli/bin.js status
+```
+
+The CLI installs its local browser runtime under `~/.dataconnect/`.
+That runtime is bundled from `vana-connect` itself, so `vana setup` does not require a separate `data-connect` checkout.
+
+To build a standalone launcher plus app payload locally:
+
+```bash
+pnpm build
+pnpm build:sea
+./artifacts/sea/vana-linux-x64/vana status --json
+```
+
+`pnpm build:sea` uses Node 25's `--build-sea` flow to create a small `vana` launcher and packages the real app payload next to it under `app/`.
+It produces a platform-specific release directory plus a release archive and matching checksum file under `artifacts/sea/`.
+
+### Programmatic runtime access
+
+If you are building an app surface like DataConnect Desktop or a hosted orchestration layer, use the SDK modules instead of shelling out to the CLI where possible.
+
+```ts
+import { ManagedPlaywrightRuntime } from "@opendatalabs/connect/runtime";
+import { listAvailableSources } from "@opendatalabs/connect/connectors";
+```
+
+Intended split:
+
+- app surfaces consume SDK/runtime APIs
+- agent skills consume the CLI
+- `data-connectors` remains the connector and schema source of truth
+
 ### Installation
 
 ```bash

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@opendatalabs/connect",
-  "version": "0.8.0",
+  "version": "0.8.1-canary.1d2cf51",
   "description": "SDK for integrating Vana Data Portability 'Connect data' flows",
   "license": "MIT",
   "repository": {
@@ -16,6 +16,9 @@
   "publishConfig": {
     "access": "public"
   },
+  "bin": {
+    "vana": "./dist/cli/bin.js"
+  },
   "files": [
     "dist"
   ],
@@ -35,12 +38,29 @@
     "./core": {
       "types": "./dist/core/index.d.ts",
       "import": "./dist/core/index.js"
+    },
+    "./runtime": {
+      "types": "./dist/runtime/index.d.ts",
+      "import": "./dist/runtime/index.js"
+    },
+    "./connectors": {
+      "types": "./dist/connectors/index.d.ts",
+      "import": "./dist/connectors/index.js"
+    },
+    "./cli": {
+      "types": "./dist/cli/main.d.ts",
+      "import": "./dist/cli/main.js"
     }
   },
   "scripts": {
     "build": "tsc --build",
-    "clean": "tsc --build --clean",
+    "build:sea": "npx -y node@25 ./scripts/build-sea.mjs",
+    "build:sea:smoke": "npx -y node@25 ./scripts/build-sea.mjs --smoke",
+    "clean": "node ./scripts/clean-build.mjs",
+    "cli": "node dist/cli/bin.js",
     "skills:sync": "node scripts/sync-skills.js",
+    "test:install:unix": "sh ./scripts/test-install-unix.sh",
+    "test:install:windows": "pwsh -File ./scripts/test-install-windows.ps1",
     "test": "vitest run",
     "test:watch": "vitest",
     "test:e2e": "vitest run --config test/e2e/vitest.config.ts",
@@ -64,9 +84,16 @@
   "engines": {
     "node": ">=20.0.0"
   },
+  "dependencies": {
+    "@inquirer/prompts": "8.3.0",
+    "chromium-bidi": "15.0.0",
+    "commander": "14.0.3",
+    "playwright": "1.58.2",
+    "zod": "4.3.6"
+  },
   "peerDependencies": {
-    "viem": "^2.0.0",
-    "react": ">=18.0.0"
+    "react": ">=18.0.0",
+    "viem": "^2.0.0"
   },
   "peerDependenciesMeta": {
     "react": {
@@ -84,6 +111,7 @@
     "@types/node": "^25.2.0",
     "@types/react": "^19.0.0",
     "conventional-changelog-conventionalcommits": "^9.1.0",
+    "esbuild": "^0.27.4",
     "eslint": "^9.39.2",
     "eslint-config-prettier": "^10.1.8",
     "husky": "^9.1.7",

package/dist/core/constants.d.ts

@@ -1,33 +0,0 @@
-/** SDK environment selector. */
-export type VanaEnvironment = "dev" | "prod";
-/** URL configuration for each SDK environment. */
-export declare const ENV_CONFIG: {
-    readonly dev: {
-        readonly sessionRelayUrl: "https://dev.session-relay.vana.org";
-        readonly gatewayUrl: "https://dev.data-gateway.vana.org";
-        readonly accountUrl: "https://account-dev.vana.org";
-    };
-    readonly prod: {
-        readonly sessionRelayUrl: "https://session-relay.vana.org";
-        readonly gatewayUrl: "https://data-gateway.vana.org";
-        readonly accountUrl: "https://account.vana.org";
-    };
-};
-/** Default environment used when none is specified. */
-export declare const DEFAULT_ENVIRONMENT: VanaEnvironment;
-/**
- * Returns the URL configuration for the given environment.
- *
- * @param environment - `"dev"` or `"prod"`. Defaults to {@link DEFAULT_ENVIRONMENT}.
- * @returns An object with `sessionRelayUrl` and `gatewayUrl`.
- */
-export declare function getEnvConfig(environment?: VanaEnvironment): {
-    readonly sessionRelayUrl: "https://dev.session-relay.vana.org";
-    readonly gatewayUrl: "https://dev.data-gateway.vana.org";
-    readonly accountUrl: "https://account-dev.vana.org";
-} | {
-    readonly sessionRelayUrl: "https://session-relay.vana.org";
-    readonly gatewayUrl: "https://data-gateway.vana.org";
-    readonly accountUrl: "https://account.vana.org";
-};
-//# sourceMappingURL=constants.d.ts.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../../src/core/constants.ts"],"names":[],"mappings":"AAAA,gCAAgC;AAChC,MAAM,MAAM,eAAe,GAAG,KAAK,GAAG,MAAM,CAAC;AAE7C,kDAAkD;AAClD,eAAO,MAAM,UAAU;;;;;;;;;;;CAWb,CAAC;AAEX,uDAAuD;AACvD,eAAO,MAAM,mBAAmB,EAAE,eAAwB,CAAC;AAE3D;;;;;GAKG;AACH,wBAAgB,YAAY,CAAC,WAAW,CAAC,EAAE,eAAe;;;;;;;;EAEzD"}

package/dist/core/constants.js

@@ -1,25 +0,0 @@
-/** URL configuration for each SDK environment. */
-export const ENV_CONFIG = {
-    dev: {
-        sessionRelayUrl: "https://dev.session-relay.vana.org",
-        gatewayUrl: "https://dev.data-gateway.vana.org",
-        accountUrl: "https://account-dev.vana.org",
-    },
-    prod: {
-        sessionRelayUrl: "https://session-relay.vana.org",
-        gatewayUrl: "https://data-gateway.vana.org",
-        accountUrl: "https://account.vana.org",
-    },
-};
-/** Default environment used when none is specified. */
-export const DEFAULT_ENVIRONMENT = "prod";
-/**
- * Returns the URL configuration for the given environment.
- *
- * @param environment - `"dev"` or `"prod"`. Defaults to {@link DEFAULT_ENVIRONMENT}.
- * @returns An object with `sessionRelayUrl` and `gatewayUrl`.
- */
-export function getEnvConfig(environment) {
-    return ENV_CONFIG[environment ?? DEFAULT_ENVIRONMENT];
-}
-//# sourceMappingURL=constants.js.map

package/dist/core/constants.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"constants.js","sourceRoot":"","sources":["../../src/core/constants.ts"],"names":[],"mappings":"AAGA,kDAAkD;AAClD,MAAM,CAAC,MAAM,UAAU,GAAG;IACxB,GAAG,EAAE;QACH,eAAe,EAAE,oCAAoC;QACrD,UAAU,EAAE,mCAAmC;QAC/C,UAAU,EAAE,8BAA8B;KAC3C;IACD,IAAI,EAAE;QACJ,eAAe,EAAE,gCAAgC;QACjD,UAAU,EAAE,+BAA+B;QAC3C,UAAU,EAAE,0BAA0B;KACvC;CACO,CAAC;AAEX,uDAAuD;AACvD,MAAM,CAAC,MAAM,mBAAmB,GAAoB,MAAM,CAAC;AAE3D;;;;;GAKG;AACH,MAAM,UAAU,YAAY,CAAC,WAA6B;IACxD,OAAO,UAAU,CAAC,WAAW,IAAI,mBAAmB,CAAC,CAAC;AACxD,CAAC"}

package/dist/core/errors.d.ts

@@ -1,47 +0,0 @@
-/**
- * Known error codes thrown by the SDK.
- *
- * Use these constants for typed `catch` handling instead of comparing raw strings.
- *
- * @example
- * ```typescript
- * import { ConnectError, ConnectErrorCode } from "@opendatalabs/connect/core";
- *
- * try {
- *   await getData({ privateKey, grant });
- * } catch (err) {
- *   if (err instanceof ConnectError && err.code === ConnectErrorCode.SERVER_NOT_FOUND) {
- *     // handle missing server
- *   }
- * }
- * ```
- */
-export declare const ConnectErrorCode: {
-    readonly SESSION_INIT_FAILED: "SESSION_INIT_FAILED";
-    readonly SESSION_EXPIRED: "SESSION_EXPIRED";
-    readonly POLL_FAILED: "POLL_FAILED";
-    readonly POLL_TIMEOUT: "POLL_TIMEOUT";
-    readonly SERVER_NOT_FOUND: "SERVER_NOT_FOUND";
-    readonly GATEWAY_ERROR: "GATEWAY_ERROR";
-    readonly DATA_FETCH_FAILED: "DATA_FETCH_FAILED";
-    readonly LIST_SCOPES_FAILED: "LIST_SCOPES_FAILED";
-    readonly LIST_VERSIONS_FAILED: "LIST_VERSIONS_FAILED";
-    readonly CONFIG_INVALID: "CONFIG_INVALID";
-    readonly WEBHOOK_INVALID: "WEBHOOK_INVALID";
-};
-/** Union type of all known error code string values. */
-export type ConnectErrorCode = (typeof ConnectErrorCode)[keyof typeof ConnectErrorCode];
-/**
- * Error class thrown by all SDK operations.
- *
- * Includes a typed {@link code} for programmatic handling and an optional
- * {@link statusCode} from HTTP responses.
- */
-export declare class ConnectError extends Error {
-    /** Machine-readable error code. One of {@link ConnectErrorCode} or an arbitrary server-returned string. */
-    readonly code: ConnectErrorCode | (string & {});
-    /** HTTP status code from the upstream response, if applicable. */
-    readonly statusCode?: number;
-    constructor(message: string, code: ConnectErrorCode | (string & {}), statusCode?: number);
-}
-//# sourceMappingURL=errors.d.ts.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../src/core/errors.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AACH,eAAO,MAAM,gBAAgB;;;;;;;;;;;;CAYnB,CAAC;AAEX,wDAAwD;AACxD,MAAM,MAAM,gBAAgB,GAC1B,CAAC,OAAO,gBAAgB,CAAC,CAAC,MAAM,OAAO,gBAAgB,CAAC,CAAC;AAE3D;;;;;GAKG;AACH,qBAAa,YAAa,SAAQ,KAAK;IACrC,2GAA2G;IAC3G,QAAQ,CAAC,IAAI,EAAE,gBAAgB,GAAG,CAAC,MAAM,GAAG,EAAE,CAAC,CAAC;IAChD,kEAAkE;IAClE,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;gBAG3B,OAAO,EAAE,MAAM,EACf,IAAI,EAAE,gBAAgB,GAAG,CAAC,MAAM,GAAG,EAAE,CAAC,EACtC,UAAU,CAAC,EAAE,MAAM;CAOtB"}

package/dist/core/errors.js

@@ -1,50 +0,0 @@
-/**
- * Known error codes thrown by the SDK.
- *
- * Use these constants for typed `catch` handling instead of comparing raw strings.
- *
- * @example
- * ```typescript
- * import { ConnectError, ConnectErrorCode } from "@opendatalabs/connect/core";
- *
- * try {
- *   await getData({ privateKey, grant });
- * } catch (err) {
- *   if (err instanceof ConnectError && err.code === ConnectErrorCode.SERVER_NOT_FOUND) {
- *     // handle missing server
- *   }
- * }
- * ```
- */
-export const ConnectErrorCode = {
-    SESSION_INIT_FAILED: "SESSION_INIT_FAILED",
-    SESSION_EXPIRED: "SESSION_EXPIRED",
-    POLL_FAILED: "POLL_FAILED",
-    POLL_TIMEOUT: "POLL_TIMEOUT",
-    SERVER_NOT_FOUND: "SERVER_NOT_FOUND",
-    GATEWAY_ERROR: "GATEWAY_ERROR",
-    DATA_FETCH_FAILED: "DATA_FETCH_FAILED",
-    LIST_SCOPES_FAILED: "LIST_SCOPES_FAILED",
-    LIST_VERSIONS_FAILED: "LIST_VERSIONS_FAILED",
-    CONFIG_INVALID: "CONFIG_INVALID",
-    WEBHOOK_INVALID: "WEBHOOK_INVALID",
-};
-/**
- * Error class thrown by all SDK operations.
- *
- * Includes a typed {@link code} for programmatic handling and an optional
- * {@link statusCode} from HTTP responses.
- */
-export class ConnectError extends Error {
-    /** Machine-readable error code. One of {@link ConnectErrorCode} or an arbitrary server-returned string. */
-    code;
-    /** HTTP status code from the upstream response, if applicable. */
-    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

@@ -1 +0,0 @@
-{"version":3,"file":"errors.js","sourceRoot":"","sources":["../../src/core/errors.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AACH,MAAM,CAAC,MAAM,gBAAgB,GAAG;IAC9B,mBAAmB,EAAE,qBAAqB;IAC1C,eAAe,EAAE,iBAAiB;IAClC,WAAW,EAAE,aAAa;IAC1B,YAAY,EAAE,cAAc;IAC5B,gBAAgB,EAAE,kBAAkB;IACpC,aAAa,EAAE,eAAe;IAC9B,iBAAiB,EAAE,mBAAmB;IACtC,kBAAkB,EAAE,oBAAoB;IACxC,oBAAoB,EAAE,sBAAsB;IAC5C,cAAc,EAAE,gBAAgB;IAChC,eAAe,EAAE,iBAAiB;CAC1B,CAAC;AAMX;;;;;GAKG;AACH,MAAM,OAAO,YAAa,SAAQ,KAAK;IACrC,2GAA2G;IAClG,IAAI,CAAmC;IAChD,kEAAkE;IACzD,UAAU,CAAU;IAE7B,YACE,OAAe,EACf,IAAsC,EACtC,UAAmB;QAEnB,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/grants.d.ts

@@ -1,19 +0,0 @@
-import type { GrantPayload } from "./types.js";
-/**
- * Type guard that checks whether an unknown value has the shape of a {@link GrantPayload}.
- *
- * Validates the presence and types of required fields: `grantId`, `userAddress`,
- * `builderAddress`, and `scopes` (non-empty string array).
- *
- * @example
- * ```typescript
- * const body = await request.json();
- * if (!isValidGrant(body.grant)) {
- *   return NextResponse.json({ error: "Invalid grant" }, { status: 400 });
- * }
- * // body.grant is now typed as GrantPayload
- * const data = await getData({ privateKey, grant: body.grant });
- * ```
- */
-export declare function isValidGrant(value: unknown): value is GrantPayload;
-//# sourceMappingURL=grants.d.ts.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"grants.d.ts","sourceRoot":"","sources":["../../src/core/grants.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAE/C;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,YAAY,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,YAAY,CAgBlE"}

package/dist/core/grants.js

@@ -1,31 +0,0 @@
-/**
- * Type guard that checks whether an unknown value has the shape of a {@link GrantPayload}.
- *
- * Validates the presence and types of required fields: `grantId`, `userAddress`,
- * `builderAddress`, and `scopes` (non-empty string array).
- *
- * @example
- * ```typescript
- * const body = await request.json();
- * if (!isValidGrant(body.grant)) {
- *   return NextResponse.json({ error: "Invalid grant" }, { status: 400 });
- * }
- * // body.grant is now typed as GrantPayload
- * const data = await getData({ privateKey, grant: body.grant });
- * ```
- */
-export function isValidGrant(value) {
-    if (value === null || typeof value !== "object")
-        return false;
-    const obj = value;
-    return (typeof obj.grantId === "string" &&
-        obj.grantId.length > 0 &&
-        typeof obj.userAddress === "string" &&
-        obj.userAddress.length > 0 &&
-        typeof obj.builderAddress === "string" &&
-        obj.builderAddress.length > 0 &&
-        Array.isArray(obj.scopes) &&
-        obj.scopes.length > 0 &&
-        obj.scopes.every((s) => typeof s === "string" && s.length > 0));
-}
-//# sourceMappingURL=grants.js.map

package/dist/core/grants.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"grants.js","sourceRoot":"","sources":["../../src/core/grants.ts"],"names":[],"mappings":"AAEA;;;;;;;;;;;;;;;GAeG;AACH,MAAM,UAAU,YAAY,CAAC,KAAc;IACzC,IAAI,KAAK,KAAK,IAAI,IAAI,OAAO,KAAK,KAAK,QAAQ;QAAE,OAAO,KAAK,CAAC;IAE9D,MAAM,GAAG,GAAG,KAAgC,CAAC;IAE7C,OAAO,CACL,OAAO,GAAG,CAAC,OAAO,KAAK,QAAQ;QAC/B,GAAG,CAAC,OAAO,CAAC,MAAM,GAAG,CAAC;QACtB,OAAO,GAAG,CAAC,WAAW,KAAK,QAAQ;QACnC,GAAG,CAAC,WAAW,CAAC,MAAM,GAAG,CAAC;QAC1B,OAAO,GAAG,CAAC,cAAc,KAAK,QAAQ;QACtC,GAAG,CAAC,cAAc,CAAC,MAAM,GAAG,CAAC;QAC7B,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC;QACzB,GAAG,CAAC,MAAM,CAAC,MAAM,GAAG,CAAC;QACrB,GAAG,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAU,EAAE,EAAE,CAAC,OAAO,CAAC,KAAK,QAAQ,IAAI,CAAC,CAAC,MAAM,GAAG,CAAC,CAAC,CACxE,CAAC;AACJ,CAAC"}

package/dist/core/index.d.ts

@@ -1,5 +0,0 @@
-export { ConnectError, ConnectErrorCode } from "./errors.js";
-export { isValidGrant } from "./grants.js";
-export { getEnvConfig, ENV_CONFIG, DEFAULT_ENVIRONMENT, type VanaEnvironment, } from "./constants.js";
-export type { ConnectionStatus, SessionInitParams, SessionInitResult, SessionPollResult, GrantPayload, DataFetchParams, RequestSignerConfig, SessionRelayConfig, DataClientConfig, ConnectConfig, GetDataConfig, VanaManifestConfig, VanaManifestBlock, } from "./types.js";
-//# sourceMappingURL=index.d.ts.map

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

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

package/dist/core/index.js

@@ -1,4 +0,0 @@
-export { ConnectError, ConnectErrorCode } from "./errors.js";
-export { isValidGrant } from "./grants.js";
-export { getEnvConfig, ENV_CONFIG, DEFAULT_ENVIRONMENT, } from "./constants.js";
-//# sourceMappingURL=index.js.map

package/dist/core/index.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/core/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAC7D,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAC3C,OAAO,EACL,YAAY,EACZ,UAAU,EACV,mBAAmB,GAEpB,MAAM,gBAAgB,CAAC"}

package/dist/core/types.d.ts

@@ -1,131 +0,0 @@
-/** Possible states of a Vana Connect session from the client's perspective. */
-export type ConnectionStatus = "idle" | "connecting" | "waiting" | "approved" | "denied" | "expired" | "error";
-/** Parameters for creating a new session on the Session Relay. */
-export interface SessionInitParams {
-    /** Data scopes to request (e.g. `["chatgpt.conversations"]`). */
-    scopes: string[];
-    /** Public HTTPS URL for grant event notifications. Localhost is rejected. */
-    webhookUrl?: string;
-    /** Your app's user ID for correlation. */
-    appUserId?: string;
-}
-/** Result returned by {@link SessionRelay.initSession}. */
-export interface SessionInitResult {
-    /** Unique session identifier used for polling. */
-    sessionId: string;
-    /** URL to account.vana.org where the user signs in and launches Data Connect. */
-    connectUrl: string;
-    /** ISO 8601 expiration timestamp for the session. */
-    expiresAt: string;
-}
-/** Result returned by {@link SessionRelay.pollSession}. */
-export interface SessionPollResult {
-    /** Current session status. */
-    status: "pending" | "claimed" | "approved" | "denied" | "expired";
-    /** Grant payload, present when status is `"approved"`. */
-    grant?: GrantPayload;
-    /** Reason for denial, present when status is `"denied"`. */
-    reason?: string;
-}
-/** Payload describing a user's approved data grant. */
-export interface GrantPayload {
-    /** On-chain permission ID. */
-    grantId: string;
-    /** User's wallet address. */
-    userAddress: string;
-    /** Builder's registered wallet address. */
-    builderAddress: string;
-    /** Approved data scopes. */
-    scopes: string[];
-    /** User's Personal Server address, if known. */
-    serverAddress?: string;
-    /** Your app's user ID, if provided during session init. */
-    appUserId?: string;
-}
-/** Parameters for fetching data from a Personal Server. */
-export interface DataFetchParams {
-    /** Base URL of the user's Personal Server. */
-    serverUrl: string;
-    /** Data scope to fetch (e.g. `"instagram.profile"`). */
-    scope: string;
-    /** Grant ID authorizing the data access. */
-    grantId: string;
-    /** Optional file ID for a specific file within the scope. */
-    fileId?: string;
-    /** Optional ISO 8601 timestamp to fetch data at a specific point in time. */
-    at?: string;
-}
-/** Configuration for {@link createRequestSigner}. */
-export interface RequestSignerConfig {
-    /** Builder private key in hex format. */
-    privateKey: `0x${string}`;
-}
-/** Configuration for {@link createSessionRelay}. */
-export interface SessionRelayConfig {
-    /** Builder private key in hex format. */
-    privateKey: `0x${string}`;
-    /** Builder's wallet address derived from the private key. */
-    granteeAddress: `0x${string}`;
-    /** Base URL of the Session Relay service. */
-    sessionRelayUrl: string;
-}
-/** Configuration for {@link createDataClient}. */
-export interface DataClientConfig {
-    /** Builder private key in hex format. */
-    privateKey: `0x${string}`;
-    /** Base URL of the Data Portability Gateway. */
-    gatewayUrl: string;
-}
-/** Configuration for the high-level {@link connect} function. */
-export interface ConnectConfig {
-    /** Builder private key in hex format. */
-    privateKey: `0x${string}`;
-    /** Data scopes to request. */
-    scopes: string[];
-    /** Public HTTPS URL for grant event notifications. */
-    webhookUrl?: string;
-    /** Your app's user ID for correlation. */
-    appUserId?: string;
-    /** SDK environment (`"dev"` or `"prod"`). Defaults to `"prod"`. */
-    environment?: "dev" | "prod";
-}
-/** Configuration for the high-level {@link getData} function. */
-export interface GetDataConfig {
-    /** Builder private key in hex format. */
-    privateKey: `0x${string}`;
-    /** Grant from the approval step. */
-    grant: GrantPayload;
-    /** SDK environment (`"dev"` or `"prod"`). Defaults to `"prod"`. */
-    environment?: "dev" | "prod";
-}
-/** Configuration for {@link signVanaManifest}. */
-export interface VanaManifestConfig {
-    /** Builder private key in hex format. */
-    privateKey: `0x${string}`;
-    /** Canonical URL of your application. */
-    appUrl: string;
-    /** URL to your privacy policy. */
-    privacyPolicyUrl: string;
-    /** URL to your terms of service. */
-    termsUrl: string;
-    /** URL for user support. */
-    supportUrl: string;
-    /** Public webhook URL for grant notifications. */
-    webhookUrl: string;
-}
-/** Signed manifest block included in your web app manifest under the `vana` key. */
-export interface VanaManifestBlock {
-    /** Canonical URL of your application. */
-    appUrl: string;
-    /** URL to your privacy policy. */
-    privacyPolicyUrl: string;
-    /** URL to your terms of service. */
-    termsUrl: string;
-    /** URL for user support. */
-    supportUrl: string;
-    /** Public webhook URL for grant notifications. */
-    webhookUrl: string;
-    /** Cryptographic signature of the manifest block. */
-    signature: string;
-}
-//# sourceMappingURL=types.d.ts.map

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

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

package/dist/core/types.js

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

package/dist/core/types.js.map

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

package/dist/index.d.ts

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

package/dist/index.d.ts.map

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

package/dist/index.js

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

package/dist/index.js.map

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

package/dist/react/ConnectButton.d.ts

@@ -1,27 +0,0 @@
-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

@@ -1 +0,0 @@
-{"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

@@ -1,39 +0,0 @@
-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

@@ -1 +0,0 @@
-{"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"}