@opendatalabs/vana-sdk 3.18.1 → 3.19.0

package/dist/tests/mock-personal-server.d.ts

@@ -14,6 +14,13 @@
  *     proof single-use; `lineage` is the body's top-level field (JSON) or
  *     the metadata object's field (binary), validated per
  *     docs/derivative-data-api.md and mirrored to `$lineage`
+ *   - derivative questions (`/v1/derivatives/questions`): the same builder
+ *     credential as a write (bearer + X-Vana-Write-Signature over the
+ *     request PATH, query string excluded, as the server verifies it),
+ *     authorized against `write:<derivedScope>`, compact JSON bodies, the
+ *     consent rule (every source scope read-granted to the builder), the
+ *     cycle guard, and the 404 a builder gets for a question it did not
+ *     register
  *   - lineage reads on both the Personal Server and the gateway: Web3Signed
  *     over the bare path (`/lineage[/:version]`, the version is a path
  *     segment, any query is 400), grant view from the signed `grantId` claim
@@ -55,6 +62,30 @@ export interface MockPersonalServerOptions {
     status?: "stored" | "syncing";
     sessionTtlSeconds?: number;
     now?: () => number;
+    /** Answer every `/v1/derivatives` route 503, as a server with no compute. */
+    computeUnavailable?: boolean;
+}
+/** A question registration the mock server holds. */
+export interface MockQuestion {
+    questionId: string;
+    derivedScope: string;
+    sourceScopes: string[];
+    question: string;
+    model: string | null;
+    registeredBy: {
+        kind: "owner";
+    } | {
+        kind: "builder";
+        builder: Address;
+        grantId: string;
+    };
+    status: "pending" | "ready" | "failed" | "stale";
+    error: string | null;
+    createdAt: string;
+    updatedAt: string;
+    lastComputedAt: string | null;
+    derivedVersion: number | null;
+    derivedCollectedAt: string | null;
 }
 export interface MockRequestLog {
     method: string;
@@ -75,6 +106,26 @@ export interface MockPersonalServer {
     respondNextWith(status: number, body: unknown): void;
     /** Sessions minted (token -> record). */
     sessions: Map<string, MockSession>;
+    /** Question registrations (id -> row), in registration order. */
+    questions: Map<string, MockQuestion>;
+    /**
+     * Forget every minted session, the way a restarted Personal Server does:
+     * the next call with an old bearer answers 401.
+     */
+    dropSessions(): void;
+    /**
+     * Settle a question the way a compute would: set its status and, for a
+     * `ready` one, store the derived record the builder then reads.
+     */
+    settleQuestion(questionId: string, outcome: {
+        status: "ready";
+        data?: Record<string, unknown>;
+    } | {
+        status: "failed";
+        error: string;
+    } | {
+        status: "stale" | "pending";
+    }): void;
 }
 export interface MockSession {
     token: string;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@opendatalabs/vana-sdk",
-  "version": "3.18.1",
+  "version": "3.19.0",
   "description": "A TypeScript library for interacting with Vana Network smart contracts.",
   "publishConfig": {
     "access": "public"