vana-cli 0.15.0

package/dist/runtime/playwright/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/runtime/playwright/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,0BAA0B,EAAE,MAAM,qBAAqB,CAAC;AACjE,OAAO,EACL,kBAAkB,EAClB,qBAAqB,EACrB,yBAAyB,EACzB,mBAAmB,EACnB,mBAAmB,EACnB,cAAc,EACd,uBAAuB,EACvB,kBAAkB,GACnB,MAAM,cAAc,CAAC"}

package/dist/runtime/repo-paths.d.ts

@@ -0,0 +1,2 @@
+export declare function findDataConnectorsDir(cwd?: string): string | null;
+//# sourceMappingURL=repo-paths.d.ts.map

package/dist/runtime/repo-paths.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"repo-paths.d.ts","sourceRoot":"","sources":["../../src/runtime/repo-paths.ts"],"names":[],"mappings":"AAGA,wBAAgB,qBAAqB,CAAC,GAAG,SAAgB,GAAG,MAAM,GAAG,IAAI,CAwCxE"}

package/dist/runtime/repo-paths.js

@@ -0,0 +1,36 @@
+import fs from "node:fs";
+import path from "node:path";
+export function findDataConnectorsDir(cwd = process.cwd()) {
+    const candidates = [];
+    const seen = new Set();
+    const pushCandidate = (value) => {
+        if (!value) {
+            return;
+        }
+        const resolved = path.resolve(value);
+        if (seen.has(resolved)) {
+            return;
+        }
+        seen.add(resolved);
+        candidates.push(resolved);
+    };
+    pushCandidate(process.env.VANA_DATA_CONNECTORS_DIR);
+    let currentDir = path.resolve(cwd);
+    while (true) {
+        pushCandidate(currentDir);
+        pushCandidate(path.join(currentDir, "data-connectors"));
+        const parentDir = path.dirname(currentDir);
+        if (parentDir === currentDir) {
+            break;
+        }
+        currentDir = parentDir;
+    }
+    for (const candidate of candidates) {
+        if (fs.existsSync(path.join(candidate, "registry.json")) &&
+            fs.existsSync(path.join(candidate, "skills", "vana-connect", "scripts"))) {
+            return candidate;
+        }
+    }
+    return null;
+}
+//# sourceMappingURL=repo-paths.js.map

package/dist/runtime/repo-paths.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"repo-paths.js","sourceRoot":"","sources":["../../src/runtime/repo-paths.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,SAAS,CAAC;AACzB,OAAO,IAAI,MAAM,WAAW,CAAC;AAE7B,MAAM,UAAU,qBAAqB,CAAC,GAAG,GAAG,OAAO,CAAC,GAAG,EAAE;IACvD,MAAM,UAAU,GAAa,EAAE,CAAC;IAChC,MAAM,IAAI,GAAG,IAAI,GAAG,EAAU,CAAC;IAE/B,MAAM,aAAa,GAAG,CAAC,KAAyB,EAAE,EAAE;QAClD,IAAI,CAAC,KAAK,EAAE,CAAC;YACX,OAAO;QACT,CAAC;QACD,MAAM,QAAQ,GAAG,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;QACrC,IAAI,IAAI,CAAC,GAAG,CAAC,QAAQ,CAAC,EAAE,CAAC;YACvB,OAAO;QACT,CAAC;QACD,IAAI,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;QACnB,UAAU,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;IAC5B,CAAC,CAAC;IAEF,aAAa,CAAC,OAAO,CAAC,GAAG,CAAC,wBAAwB,CAAC,CAAC;IAEpD,IAAI,UAAU,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;IACnC,OAAO,IAAI,EAAE,CAAC;QACZ,aAAa,CAAC,UAAU,CAAC,CAAC;QAC1B,aAAa,CAAC,IAAI,CAAC,IAAI,CAAC,UAAU,EAAE,iBAAiB,CAAC,CAAC,CAAC;QAExD,MAAM,SAAS,GAAG,IAAI,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC;QAC3C,IAAI,SAAS,KAAK,UAAU,EAAE,CAAC;YAC7B,MAAM;QACR,CAAC;QACD,UAAU,GAAG,SAAS,CAAC;IACzB,CAAC;IAED,KAAK,MAAM,SAAS,IAAI,UAAU,EAAE,CAAC;QACnC,IACE,EAAE,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,eAAe,CAAC,CAAC;YACpD,EAAE,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,QAAQ,EAAE,cAAc,EAAE,SAAS,CAAC,CAAC,EACxE,CAAC;YACD,OAAO,SAAS,CAAC;QACnB,CAAC;IACH,CAAC;IAED,OAAO,IAAI,CAAC;AACd,CAAC"}

package/dist/server/config.d.ts

@@ -0,0 +1,38 @@
+import type { VanaEnvironment } from "../core/constants.js";
+export interface VanaConfig {
+    privateKey: `0x${string}`;
+    scopes: string[];
+    appUrl: string;
+    dataSource?: string;
+    environment?: VanaEnvironment;
+}
+/**
+ * Creates a validated SDK configuration.
+ *
+ * All values must be passed explicitly — the SDK does not read
+ * environment variables. The calling application is responsible
+ * for sourcing config values (e.g. from `process.env`).
+ *
+ * @param config - Required configuration fields.
+ * @returns A validated {@link VanaConfig} object.
+ * @throws {@link ConnectError} with code `CONFIG_INVALID` if any required field is missing or invalid.
+ *
+ * @example
+ * ```typescript
+ * import { createVanaConfig } from "vana-cli/server";
+ *
+ * const config = createVanaConfig({
+ *   privateKey: process.env.VANA_PRIVATE_KEY as `0x${string}`,
+ *   scopes: ["chatgpt.conversations"],
+ *   appUrl: process.env.APP_URL!,
+ * });
+ * ```
+ */
+export declare function createVanaConfig(config: {
+    privateKey: `0x${string}`;
+    scopes: string[];
+    appUrl: string;
+    dataSource?: string;
+    environment?: VanaEnvironment;
+}): VanaConfig;
+//# sourceMappingURL=config.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../../src/server/config.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AAG5D,MAAM,WAAW,UAAU;IACzB,UAAU,EAAE,KAAK,MAAM,EAAE,CAAC;IAC1B,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC;IACf,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,WAAW,CAAC,EAAE,eAAe,CAAC;CAC/B;AAED;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,wBAAgB,gBAAgB,CAAC,MAAM,EAAE;IACvC,UAAU,EAAE,KAAK,MAAM,EAAE,CAAC;IAC1B,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC;IACf,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,WAAW,CAAC,EAAE,eAAe,CAAC;CAC/B,GAAG,UAAU,CAoCb"}

package/dist/server/config.js

@@ -0,0 +1,45 @@
+import { ConnectError, ConnectErrorCode } from "../core/errors.js";
+/**
+ * Creates a validated SDK configuration.
+ *
+ * All values must be passed explicitly — the SDK does not read
+ * environment variables. The calling application is responsible
+ * for sourcing config values (e.g. from `process.env`).
+ *
+ * @param config - Required configuration fields.
+ * @returns A validated {@link VanaConfig} object.
+ * @throws {@link ConnectError} with code `CONFIG_INVALID` if any required field is missing or invalid.
+ *
+ * @example
+ * ```typescript
+ * import { createVanaConfig } from "vana-cli/server";
+ *
+ * const config = createVanaConfig({
+ *   privateKey: process.env.VANA_PRIVATE_KEY as `0x${string}`,
+ *   scopes: ["chatgpt.conversations"],
+ *   appUrl: process.env.APP_URL!,
+ * });
+ * ```
+ */
+export function createVanaConfig(config) {
+    if (!config.privateKey) {
+        throw new ConnectError("Missing privateKey. Pass a 0x-prefixed private key.", ConnectErrorCode.CONFIG_INVALID);
+    }
+    if (!config.privateKey.startsWith("0x")) {
+        throw new ConnectError("privateKey must start with 0x.", ConnectErrorCode.CONFIG_INVALID);
+    }
+    if (!Array.isArray(config.scopes) || config.scopes.length === 0) {
+        throw new ConnectError("Missing scopes. Pass a non-empty array of scope strings.", ConnectErrorCode.CONFIG_INVALID);
+    }
+    if (!config.appUrl) {
+        throw new ConnectError("Missing appUrl. Pass the public URL of your deployed app.", ConnectErrorCode.CONFIG_INVALID);
+    }
+    return {
+        privateKey: config.privateKey,
+        scopes: config.scopes,
+        appUrl: config.appUrl,
+        dataSource: config.dataSource,
+        environment: config.environment,
+    };
+}
+//# sourceMappingURL=config.js.map

package/dist/server/config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.js","sourceRoot":"","sources":["../../src/server/config.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,YAAY,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAC;AAUnE;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,MAAM,UAAU,gBAAgB,CAAC,MAMhC;IACC,IAAI,CAAC,MAAM,CAAC,UAAU,EAAE,CAAC;QACvB,MAAM,IAAI,YAAY,CACpB,qDAAqD,EACrD,gBAAgB,CAAC,cAAc,CAChC,CAAC;IACJ,CAAC;IAED,IAAI,CAAC,MAAM,CAAC,UAAU,CAAC,UAAU,CAAC,IAAI,CAAC,EAAE,CAAC;QACxC,MAAM,IAAI,YAAY,CACpB,gCAAgC,EAChC,gBAAgB,CAAC,cAAc,CAChC,CAAC;IACJ,CAAC;IAED,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,MAAM,CAAC,IAAI,MAAM,CAAC,MAAM,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAChE,MAAM,IAAI,YAAY,CACpB,0DAA0D,EAC1D,gBAAgB,CAAC,cAAc,CAChC,CAAC;IACJ,CAAC;IAED,IAAI,CAAC,MAAM,CAAC,MAAM,EAAE,CAAC;QACnB,MAAM,IAAI,YAAY,CACpB,2DAA2D,EAC3D,gBAAgB,CAAC,cAAc,CAChC,CAAC;IACJ,CAAC;IAED,OAAO;QACL,UAAU,EAAE,MAAM,CAAC,UAAU;QAC7B,MAAM,EAAE,MAAM,CAAC,MAAM;QACrB,MAAM,EAAE,MAAM,CAAC,MAAM;QACrB,UAAU,EAAE,MAAM,CAAC,UAAU;QAC7B,WAAW,EAAE,MAAM,CAAC,WAAW;KAChC,CAAC;AACJ,CAAC"}

package/dist/server/connect.d.ts

@@ -0,0 +1,43 @@
+import type { ConnectConfig, GetDataConfig, SessionInitResult } from "../core/types.js";
+/**
+ * Creates a session on the Session Relay and returns the session ID, connect URL, and deep link URL.
+ *
+ * This is the entry point for the Vana Connect flow. The returned `connectUrl`
+ * should be presented to the user to sign in on account.vana.org and launch Data Connect.
+ *
+ * @param config - Connection configuration including private key and scopes.
+ * @returns Session ID, connect URL, and expiration timestamp.
+ * @throws {@link ConnectError} with code `SESSION_INIT_FAILED` if the relay rejects the request.
+ *
+ * @example
+ * ```typescript
+ * const session = await connect({
+ *   privateKey: process.env.VANA_PRIVATE_KEY as `0x${string}`,
+ *   scopes: ["chatgpt.conversations"],
+ * });
+ * // session.sessionId, session.connectUrl, session.expiresAt
+ * ```
+ */
+export declare function connect(config: ConnectConfig): Promise<SessionInitResult>;
+/**
+ * Fetches user data from their Personal Server using a signed grant.
+ *
+ * Resolves the server URL via the Data Portability Gateway, then fetches
+ * data for each scope in the grant concurrently.
+ *
+ * @param config - Data fetch configuration including private key and grant.
+ * @returns A `Record` keyed by scope name with the fetched data as values.
+ * @throws {@link ConnectError} with code `SERVER_NOT_FOUND` if no server is registered.
+ * @throws {@link ConnectError} with code `DATA_FETCH_FAILED` if a scope fetch fails.
+ *
+ * @example
+ * ```typescript
+ * const data = await getData({
+ *   privateKey: process.env.VANA_PRIVATE_KEY as `0x${string}`,
+ *   grant,
+ * });
+ * const conversations = data["chatgpt.conversations"];
+ * ```
+ */
+export declare function getData(config: GetDataConfig): Promise<Record<string, unknown>>;
+//# sourceMappingURL=connect.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"connect.d.ts","sourceRoot":"","sources":["../../src/server/connect.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EACV,aAAa,EACb,aAAa,EACb,iBAAiB,EAClB,MAAM,kBAAkB,CAAC;AAK1B;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAsB,OAAO,CAC3B,MAAM,EAAE,aAAa,GACpB,OAAO,CAAC,iBAAiB,CAAC,CAsD5B;AAED;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAsB,OAAO,CAC3B,MAAM,EAAE,aAAa,GACpB,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CA8BlC"}

package/dist/server/connect.js

@@ -0,0 +1,115 @@
+import { getEnvConfig } from "../core/constants.js";
+import { createRequestSigner } from "./request-signer.js";
+import { createSessionRelay } from "./session-relay.js";
+import { createDataClient } from "./data-client.js";
+/**
+ * Creates a session on the Session Relay and returns the session ID, connect URL, and deep link URL.
+ *
+ * This is the entry point for the Vana Connect flow. The returned `connectUrl`
+ * should be presented to the user to sign in on account.vana.org and launch Data Connect.
+ *
+ * @param config - Connection configuration including private key and scopes.
+ * @returns Session ID, connect URL, and expiration timestamp.
+ * @throws {@link ConnectError} with code `SESSION_INIT_FAILED` if the relay rejects the request.
+ *
+ * @example
+ * ```typescript
+ * const session = await connect({
+ *   privateKey: process.env.VANA_PRIVATE_KEY as `0x${string}`,
+ *   scopes: ["chatgpt.conversations"],
+ * });
+ * // session.sessionId, session.connectUrl, session.expiresAt
+ * ```
+ */
+export async function connect(config) {
+    const { sessionRelayUrl, accountUrl } = getEnvConfig(config.environment);
+    const signer = createRequestSigner({ privateKey: config.privateKey });
+    const granteeAddress = signer.address;
+    const mode = config.mode ?? "connect";
+    const scopes = config.scopes && config.scopes.length > 0
+        ? config.scopes
+        : mode === "auth"
+            ? ["identity.auth"]
+            : [];
+    const relay = createSessionRelay({
+        privateKey: config.privateKey,
+        granteeAddress,
+        sessionRelayUrl,
+    });
+    const relayResult = await relay.initSession({
+        scopes,
+        webhookUrl: config.webhookUrl,
+        appUserId: config.appUserId,
+    });
+    // Build the account.vana.org connect URL from the relay response
+    const connectUrl = new URL("/connect", accountUrl);
+    connectUrl.searchParams.set("sessionId", relayResult.sessionId);
+    if (mode === "auth") {
+        connectUrl.searchParams.set("mode", "auth");
+        connectUrl.searchParams.set("relayUrl", sessionRelayUrl);
+    }
+    if (typeof config.appUrl === "string" && config.appUrl.trim().length > 0) {
+        connectUrl.searchParams.set("appUrl", config.appUrl.trim());
+    }
+    if (typeof config.dataSource === "string" &&
+        config.dataSource.trim().length > 0) {
+        connectUrl.searchParams.set("dataSource", config.dataSource.trim());
+    }
+    try {
+        const deepLinkParams = new URL(relayResult.deepLinkUrl);
+        const secret = deepLinkParams.searchParams.get("secret");
+        if (secret)
+            connectUrl.searchParams.set("secret", secret);
+    }
+    catch {
+        // deepLinkUrl may not be a valid URL; proceed without secret
+    }
+    return {
+        sessionId: relayResult.sessionId,
+        connectUrl: connectUrl.toString(),
+        expiresAt: relayResult.expiresAt,
+    };
+}
+/**
+ * Fetches user data from their Personal Server using a signed grant.
+ *
+ * Resolves the server URL via the Data Portability Gateway, then fetches
+ * data for each scope in the grant concurrently.
+ *
+ * @param config - Data fetch configuration including private key and grant.
+ * @returns A `Record` keyed by scope name with the fetched data as values.
+ * @throws {@link ConnectError} with code `SERVER_NOT_FOUND` if no server is registered.
+ * @throws {@link ConnectError} with code `DATA_FETCH_FAILED` if a scope fetch fails.
+ *
+ * @example
+ * ```typescript
+ * const data = await getData({
+ *   privateKey: process.env.VANA_PRIVATE_KEY as `0x${string}`,
+ *   grant,
+ * });
+ * const conversations = data["chatgpt.conversations"];
+ * ```
+ */
+export async function getData(config) {
+    const { gatewayUrl } = getEnvConfig(config.environment);
+    const { grant } = config;
+    const dataClient = createDataClient({
+        privateKey: config.privateKey,
+        gatewayUrl,
+    });
+    const serverUrl = await dataClient.resolveServerUrl(grant.serverAddress ?? grant.userAddress);
+    const results = await Promise.all(grant.scopes.map(async (scope) => {
+        const result = await dataClient.fetchData({
+            serverUrl,
+            scope,
+            grantId: grant.grantId,
+        });
+        return [scope, result];
+    }));
+    const data = {};
+    for (const [scope, result] of results) {
+        data[scope] = result;
+    }
+    return data;
+}
+//# sourceMappingURL=connect.js.map

package/dist/server/connect.js.map

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

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

@@ -0,0 +1,31 @@
+import type { DataClientConfig, DataFetchParams } from "../core/types.js";
+/**
+ * Low-level client for the Data Portability Gateway and Personal Servers.
+ *
+ * @see {@link createDataClient} to create an instance.
+ */
+export interface DataClient {
+    /** Resolves a user's Personal Server URL via the gateway. */
+    resolveServerUrl(userAddress: string): Promise<string>;
+    /** Fetches data for a single scope from a Personal Server. */
+    fetchData(params: DataFetchParams): Promise<unknown>;
+    /** Lists available scopes on a Personal Server. */
+    listScopes(params: {
+        serverUrl: string;
+    }): Promise<unknown>;
+    /** Lists available versions for a scope on a Personal Server. */
+    listVersions(params: {
+        serverUrl: string;
+        scope: string;
+    }): Promise<unknown>;
+}
+/**
+ * Creates a low-level Data Gateway / Personal Server client.
+ *
+ * Prefer the high-level {@link getData} function for most use cases.
+ *
+ * @param config - Data client configuration.
+ * @returns A {@link DataClient} instance.
+ */
+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;;;;GAIG;AACH,MAAM,WAAW,UAAU;IACzB,6DAA6D;IAC7D,gBAAgB,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;IACvD,8DAA8D;IAC9D,SAAS,CAAC,MAAM,EAAE,eAAe,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IACrD,mDAAmD;IACnD,UAAU,CAAC,MAAM,EAAE;QAAE,SAAS,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IAC5D,iEAAiE;IACjE,YAAY,CAAC,MAAM,EAAE;QAAE,SAAS,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;CAC9E;AAED;;;;;;;GAOG;AACH,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,gBAAgB,GAAG,UAAU,CA6HrE"}

package/dist/server/data-client.js

@@ -0,0 +1,95 @@
+import { ConnectError, ConnectErrorCode } from "../core/errors.js";
+import { createRequestSigner } from "./request-signer.js";
+/**
+ * Creates a low-level Data Gateway / Personal Server client.
+ *
+ * Prefer the high-level {@link getData} function for most use cases.
+ *
+ * @param config - Data client configuration.
+ * @returns A {@link DataClient} instance.
+ */
+export function createDataClient(config) {
+    const gatewayBase = config.gatewayUrl.replace(/\/+$/, "");
+    const signer = createRequestSigner({
+        privateKey: config.privateKey,
+        bodyHashFormat: "prefixed",
+    });
+    return {
+        async resolveServerUrl(userAddress) {
+            const res = await fetch(`${gatewayBase}/v1/servers/${userAddress}`);
+            if (res.status === 404) {
+                throw new ConnectError(`No server registered for ${userAddress}`, ConnectErrorCode.SERVER_NOT_FOUND, 404);
+            }
+            if (!res.ok) {
+                throw new ConnectError(`Gateway error: ${res.status}`, ConnectErrorCode.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 url = `${base}${uri}`;
+            const res = await fetch(url, {
+                headers: { Authorization: authHeader },
+            });
+            if (!res.ok) {
+                const body = await res.text().catch(() => "(unreadable)");
+                console.error("[data-client] fetchData failed", {
+                    status: res.status,
+                    url,
+                    scope: params.scope,
+                    grantId: params.grantId,
+                    body,
+                });
+                throw new ConnectError(`Data fetch failed: ${res.status}`, ConnectErrorCode.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}`, ConnectErrorCode.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}`, ConnectErrorCode.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,8 @@
+export { createRequestSigner, type RequestSigner } from "./request-signer.js";
+export { createSessionRelay, type SessionRelay, type RelaySessionInitResult, } from "./session-relay.js";
+export { createDataClient, type DataClient } from "./data-client.js";
+export { connect, getData } from "./connect.js";
+export { signVanaManifest } from "./manifest-signer.js";
+export { createVanaConfig, type VanaConfig } from "./config.js";
+export { verifyWebhook } from "./webhook.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,EACL,kBAAkB,EAClB,KAAK,YAAY,EACjB,KAAK,sBAAsB,GAC5B,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EAAE,gBAAgB,EAAE,KAAK,UAAU,EAAE,MAAM,kBAAkB,CAAC;AACrE,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AAChD,OAAO,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AACxD,OAAO,EAAE,gBAAgB,EAAE,KAAK,UAAU,EAAE,MAAM,aAAa,CAAC;AAChE,OAAO,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC"}

package/dist/server/index.js

@@ -0,0 +1,8 @@
+export { createRequestSigner } from "./request-signer.js";
+export { createSessionRelay, } from "./session-relay.js";
+export { createDataClient } from "./data-client.js";
+export { connect, getData } from "./connect.js";
+export { signVanaManifest } from "./manifest-signer.js";
+export { createVanaConfig } from "./config.js";
+export { verifyWebhook } from "./webhook.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,EACL,kBAAkB,GAGnB,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EAAE,gBAAgB,EAAmB,MAAM,kBAAkB,CAAC;AACrE,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AAChD,OAAO,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AACxD,OAAO,EAAE,gBAAgB,EAAmB,MAAM,aAAa,CAAC;AAChE,OAAO,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC"}

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

@@ -0,0 +1,25 @@
+import type { VanaManifestConfig, VanaManifestBlock } from "../core/types.js";
+/**
+ * Signs a web app manifest block for Vana Desktop App identity verification.
+ *
+ * Include the returned block under the `vana` key in your web app manifest JSON,
+ * and make sure your HTML has `<link rel="manifest" href="/manifest.json">`.
+ *
+ * @param config - Manifest configuration including private key and app URLs.
+ * @returns A signed {@link VanaManifestBlock}.
+ *
+ * @example
+ * ```typescript
+ * const vanaBlock = await signVanaManifest({
+ *   privateKey: process.env.VANA_PRIVATE_KEY as `0x${string}`,
+ *   appUrl: "https://yourapp.com",
+ *   privacyPolicyUrl: "https://yourapp.com/privacy",
+ *   termsUrl: "https://yourapp.com/terms",
+ *   supportUrl: "https://yourapp.com/support",
+ *   webhookUrl: "https://yourapp.com/api/webhook",
+ * });
+ * const manifest = { name: "Your App", vana: vanaBlock };
+ * ```
+ */
+export declare function signVanaManifest(config: VanaManifestConfig): Promise<VanaManifestBlock>;
+//# sourceMappingURL=manifest-signer.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"manifest-signer.d.ts","sourceRoot":"","sources":["../../src/server/manifest-signer.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,kBAAkB,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AAa9E;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,wBAAsB,gBAAgB,CACpC,MAAM,EAAE,kBAAkB,GACzB,OAAO,CAAC,iBAAiB,CAAC,CAgB5B"}

package/dist/server/manifest-signer.js

@@ -0,0 +1,51 @@
+import { privateKeyToAccount } from "viem/accounts";
+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;
+}
+/**
+ * Signs a web app manifest block for Vana Desktop App identity verification.
+ *
+ * Include the returned block under the `vana` key in your web app manifest JSON,
+ * and make sure your HTML has `<link rel="manifest" href="/manifest.json">`.
+ *
+ * @param config - Manifest configuration including private key and app URLs.
+ * @returns A signed {@link VanaManifestBlock}.
+ *
+ * @example
+ * ```typescript
+ * const vanaBlock = await signVanaManifest({
+ *   privateKey: process.env.VANA_PRIVATE_KEY as `0x${string}`,
+ *   appUrl: "https://yourapp.com",
+ *   privacyPolicyUrl: "https://yourapp.com/privacy",
+ *   termsUrl: "https://yourapp.com/terms",
+ *   supportUrl: "https://yourapp.com/support",
+ *   webhookUrl: "https://yourapp.com/api/webhook",
+ * });
+ * const manifest = { name: "Your App", vana: vanaBlock };
+ * ```
+ */
+export async function signVanaManifest(config) {
+    const account = privateKeyToAccount(config.privateKey);
+    const block = {
+        appUrl: config.appUrl,
+        privacyPolicyUrl: config.privacyPolicyUrl,
+        supportUrl: config.supportUrl,
+        termsUrl: config.termsUrl,
+        webhookUrl: config.webhookUrl,
+    };
+    const canonical = canonicalizeJson(block);
+    const message = JSON.stringify(canonical);
+    const signature = await account.signMessage({ message });
+    return { ...block, signature };
+}
+//# sourceMappingURL=manifest-signer.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"manifest-signer.js","sourceRoot":"","sources":["../../src/server/manifest-signer.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,mBAAmB,EAAE,MAAM,eAAe,CAAC;AAGpD,SAAS,gBAAgB,CAAC,GAAY;IACpC,IAAI,GAAG,KAAK,IAAI,IAAI,OAAO,GAAG,KAAK,QAAQ;QAAE,OAAO,GAAG,CAAC;IACxD,IAAI,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC;QAAE,OAAO,GAAG,CAAC,GAAG,CAAC,gBAAgB,CAAC,CAAC;IACzD,MAAM,MAAM,GAA4B,EAAE,CAAC;IAC3C,KAAK,MAAM,GAAG,IAAI,MAAM,CAAC,IAAI,CAAC,GAA8B,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC;QACrE,IAAI,GAAG,KAAK,WAAW;YAAE,SAAS;QAClC,MAAM,CAAC,GAAG,CAAC,GAAG,gBAAgB,CAAE,GAA+B,CAAC,GAAG,CAAC,CAAC,CAAC;IACxE,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC;AAED;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,MAAM,CAAC,KAAK,UAAU,gBAAgB,CACpC,MAA0B;IAE1B,MAAM,OAAO,GAAG,mBAAmB,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC;IAEvD,MAAM,KAAK,GAAG;QACZ,MAAM,EAAE,MAAM,CAAC,MAAM;QACrB,gBAAgB,EAAE,MAAM,CAAC,gBAAgB;QACzC,UAAU,EAAE,MAAM,CAAC,UAAU;QAC7B,QAAQ,EAAE,MAAM,CAAC,QAAQ;QACzB,UAAU,EAAE,MAAM,CAAC,UAAU;KAC9B,CAAC;IAEF,MAAM,SAAS,GAAG,gBAAgB,CAAC,KAAK,CAAC,CAAC;IAC1C,MAAM,OAAO,GAAG,IAAI,CAAC,SAAS,CAAC,SAAS,CAAC,CAAC;IAC1C,MAAM,SAAS,GAAG,MAAM,OAAO,CAAC,WAAW,CAAC,EAAE,OAAO,EAAE,CAAC,CAAC;IAEzD,OAAO,EAAE,GAAG,KAAK,EAAE,SAAS,EAAE,CAAC;AACjC,CAAC"}

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

@@ -0,0 +1,31 @@
+import type { RequestSignerConfig } from "../core/types.js";
+/**
+ * Generates `Web3Signed` authorization headers for protocol requests.
+ *
+ * @see {@link createRequestSigner} to create an instance.
+ */
+export interface RequestSigner {
+    /**
+     * Signs a request and returns the `Authorization` header value.
+     *
+     * @param params - Request metadata (audience, method, URI, optional body and grantId).
+     * @returns A `Web3Signed <payload>.<signature>` header string.
+     */
+    signRequest(params: {
+        aud: string;
+        method: string;
+        uri: string;
+        body?: string;
+        grantId?: string;
+    }): Promise<string>;
+    /** The wallet address derived from the private key. */
+    readonly address: `0x${string}`;
+}
+/**
+ * Creates a request signer that generates `Web3Signed` authorization headers.
+ *
+ * @param config - Configuration containing the builder's private key.
+ * @returns A {@link RequestSigner} instance.
+ */
+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;AAuC5D;;;;GAIG;AACH,MAAM,WAAW,aAAa;IAC5B;;;;;OAKG;IACH,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,uDAAuD;IACvD,QAAQ,CAAC,OAAO,EAAE,KAAK,MAAM,EAAE,CAAC;CACjC;AAED;;;;;GAKG;AACH,wBAAgB,mBAAmB,CACjC,MAAM,EAAE,mBAAmB,GAC1B,aAAa,CAuCf"}