@vaultgraph/sdk 0.1.7 → 0.1.8

package/README.md

@@ -147,6 +147,31 @@ const updated = await agents.update(created.id, {
 await agents.delete(updated.id);
 ```
 
+### Manage consumers via the API (server-only)
+
+```ts
+import { createConsumersClient } from "@vaultgraph/sdk";
+
+const consumers = createConsumersClient({
+  apiKey: process.env.VAULTGRAPH_VENDOR_API_KEY!,
+});
+
+const created = await consumers.create({
+  name: "Acme Holdings",
+  description: "Primary customer record.",
+});
+
+const list = await consumers.list();
+const detail = await consumers.get(created.id);
+
+const updated = await consumers.update(created.id, {
+  name: "Acme Holdings v2",
+  description: "Updated customer record.",
+});
+
+await consumers.delete(updated.id);
+```
+
 ## API surface
 
 - `hashContext(value, options?)` → sha256 hash of canonical JSON/bytes
@@ -158,8 +183,9 @@ await agents.delete(updated.id);
 - `submitSignedReceipt(options)` → creates, signs, and submits; defaults `apiUrl` to portal base
 - `submitReceipt(options)` → POSTs to `/api/receipts` (requires `apiKey`)
 - `createAgentsClient(options)` → CRUD helper for `/api/agents`
+- `createConsumersClient(options)` → CRUD helper for `/api/consumers`
 - `generateKeyPair()` → returns PEM-encoded Ed25519 keypair
-- Types: `CreateReceiptInput`, `JobReceipt`, `JobReceiptV0`, `JobResolution`, `ReceiptVersion`, `SubmitReceiptOptions`, `SubmitReceiptResponse`, `AgentRecord`, `AgentCreateInput`, `AgentUpdateInput`, `AgentsClientOptions`, `AgentsClient`
+- Types: `CreateReceiptInput`, `JobReceipt`, `JobReceiptV0`, `JobResolution`, `ReceiptVersion`, `SubmitReceiptOptions`, `SubmitReceiptResponse`, `AgentRecord`, `AgentCreateInput`, `AgentUpdateInput`, `AgentsClientOptions`, `AgentsClient`, `ConsumerRecord`, `ConsumerCreateInput`, `ConsumerUpdateInput`, `ConsumersClientOptions`, `ConsumersClient`
 
 ## Notes
 

package/dist/index.d.ts

@@ -55,6 +55,59 @@ interface AgentsClient {
  */
 declare function createAgentsClient(options: AgentsClientOptions): AgentsClient;
 
+/**
+ * Consumer record returned by the API.
+ */
+interface ConsumerRecord {
+    id: string;
+    name: string;
+    description: string | null;
+    linked_consumer_org_id: string | null;
+    linked_at: string | null;
+    created_at: string;
+    updated_at: string;
+}
+/**
+ * Payload for creating consumers.
+ */
+interface ConsumerCreateInput {
+    name: string;
+    description?: string | null;
+}
+/**
+ * Payload for updating consumers.
+ */
+interface ConsumerUpdateInput {
+    name: string;
+    description?: string | null;
+}
+/**
+ * Configuration for `createConsumersClient`.
+ */
+interface ConsumersClientOptions {
+    apiKey: string;
+    /** API base URL; defaults to the portal URL (app.vaultgraph.com in prod). */
+    apiUrl?: string;
+    fetchImpl?: typeof fetch;
+}
+/**
+ * Client interface for the consumer API.
+ */
+interface ConsumersClient {
+    list: () => Promise<ConsumerRecord[]>;
+    get: (id: string) => Promise<ConsumerRecord>;
+    create: (input: ConsumerCreateInput) => Promise<ConsumerRecord>;
+    update: (id: string, input: ConsumerUpdateInput) => Promise<ConsumerRecord>;
+    delete: (id: string) => Promise<{
+        id: string;
+    }>;
+}
+
+/**
+ * Creates a minimal API client for managing consumers.
+ */
+declare function createConsumersClient(options: ConsumersClientOptions): ConsumersClient;
+
 /**
  * Input for `createSignedReceipt`.
  */
@@ -102,4 +155,4 @@ declare function generateKeyPair(): {
     publicKey: string;
 };
 
-export { type AgentCreateInput, type AgentRecord, type AgentUpdateInput, type AgentsClient, type AgentsClientOptions, type CreateSignedReceiptOptions, type SubmitSignedReceiptOptions, createAgentsClient, createSignedReceipt, generateKeyPair, submitSignedReceipt };
+export { type AgentCreateInput, type AgentRecord, type AgentUpdateInput, type AgentsClient, type AgentsClientOptions, type ConsumerCreateInput, type ConsumerRecord, type ConsumerUpdateInput, type ConsumersClient, type ConsumersClientOptions, type CreateSignedReceiptOptions, type SubmitSignedReceiptOptions, createAgentsClient, createConsumersClient, createSignedReceipt, generateKeyPair, submitSignedReceipt };

package/dist/index.js

@@ -260,6 +260,38 @@ async function safeParseJson2(response) {
   }
 }
 
+// src/shared/records.ts
+function extractDataArray(payload, label) {
+  if (!payload || typeof payload !== "object") {
+    throw new Error(`Invalid ${label} response payload`);
+  }
+  const data = payload.data;
+  if (!Array.isArray(data)) {
+    throw new Error(`Invalid ${label} response data`);
+  }
+  return data;
+}
+function extractDataRecord(payload, label) {
+  if (!payload || typeof payload !== "object") {
+    throw new Error(`Invalid ${label} response payload`);
+  }
+  const data = payload.data;
+  if (!data || typeof data !== "object") {
+    throw new Error(`Invalid ${label} response data`);
+  }
+  return data;
+}
+function extractDeleteResponse(payload) {
+  if (!payload || typeof payload !== "object") {
+    throw new Error("Invalid delete response payload");
+  }
+  const id = payload.id;
+  if (!id) {
+    throw new Error("Invalid delete response data");
+  }
+  return { id };
+}
+
 // src/agents/client.ts
 function createAgentsClient(options) {
   const { apiKey, apiUrl, fetchImpl } = options;
@@ -335,35 +367,81 @@ function createAgentsClient(options) {
     }
   };
 }
-function extractDataArray(payload, label) {
-  if (!payload || typeof payload !== "object") {
-    throw new Error(`Invalid ${label} response payload`);
-  }
-  const data = payload.data;
-  if (!Array.isArray(data)) {
-    throw new Error(`Invalid ${label} response data`);
-  }
-  return data;
-}
-function extractDataRecord(payload, label) {
-  if (!payload || typeof payload !== "object") {
-    throw new Error(`Invalid ${label} response payload`);
-  }
-  const data = payload.data;
-  if (!data || typeof data !== "object") {
-    throw new Error(`Invalid ${label} response data`);
-  }
-  return data;
-}
-function extractDeleteResponse(payload) {
-  if (!payload || typeof payload !== "object") {
-    throw new Error("Invalid delete response payload");
-  }
-  const id = payload.id;
-  if (!id) {
-    throw new Error("Invalid delete response data");
-  }
-  return { id };
+
+// src/consumers/client.ts
+function createConsumersClient(options) {
+  const { apiKey, apiUrl, fetchImpl } = options;
+  const targetApiUrl = apiUrl ?? getPortalURL();
+  assertNonEmpty(apiKey, "apiKey");
+  assertNonEmpty(targetApiUrl, "apiUrl");
+  return {
+    list: async () => {
+      const payload = await requestJson({
+        apiUrl: targetApiUrl,
+        apiKey,
+        path: "/api/consumers",
+        method: "GET",
+        fetchImpl
+      });
+      return extractDataArray(payload, "consumers");
+    },
+    get: async (id) => {
+      assertNonEmpty(id, "id");
+      const encodedId = encodeURIComponent(id);
+      const payload = await requestJson({
+        apiUrl: targetApiUrl,
+        apiKey,
+        path: `/api/consumers/${encodedId}`,
+        method: "GET",
+        fetchImpl
+      });
+      return extractDataRecord(payload, "consumer");
+    },
+    create: async (input) => {
+      assertNonEmpty(input.name, "name");
+      const payload = await requestJson({
+        apiUrl: targetApiUrl,
+        apiKey,
+        path: "/api/consumers",
+        method: "POST",
+        body: {
+          name: input.name,
+          description: input.description ?? null
+        },
+        fetchImpl
+      });
+      return extractDataRecord(payload, "consumer");
+    },
+    update: async (id, input) => {
+      assertNonEmpty(id, "id");
+      assertNonEmpty(input.name, "name");
+      const encodedId = encodeURIComponent(id);
+      const payload = await requestJson({
+        apiUrl: targetApiUrl,
+        apiKey,
+        path: `/api/consumers/${encodedId}`,
+        method: "PUT",
+        body: {
+          name: input.name,
+          description: input.description ?? null
+        },
+        fetchImpl
+      });
+      return extractDataRecord(payload, "consumer");
+    },
+    delete: async (id) => {
+      assertNonEmpty(id, "id");
+      const encodedId = encodeURIComponent(id);
+      const payload = await requestJson({
+        apiUrl: targetApiUrl,
+        apiKey,
+        path: `/api/consumers/${encodedId}`,
+        method: "DELETE",
+        fetchImpl
+      });
+      return extractDeleteResponse(payload);
+    }
+  };
 }
 function createSignedReceipt(options) {
   const { privateKey, algorithm, encoding, ...receiptInput } = options;
@@ -398,4 +476,4 @@ function generateKeyPair() {
   return { privateKey, publicKey };
 }
 
-export { JOB_RESOLUTIONS, canonicalJSONStringify, createAgentsClient, createReceipt, createSignedReceipt, generateKeyPair, hashContext, jobReceiptV0Schema, serializeReceipt, signReceipt, submitReceipt, submitSignedReceipt, verifyReceipt };
+export { JOB_RESOLUTIONS, canonicalJSONStringify, createAgentsClient, createConsumersClient, createReceipt, createSignedReceipt, generateKeyPair, hashContext, jobReceiptV0Schema, serializeReceipt, signReceipt, submitReceipt, submitSignedReceipt, verifyReceipt };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@vaultgraph/sdk",
-  "version": "0.1.7",
+  "version": "0.1.8",
   "private": false,
   "type": "module",
   "license": "MIT",