@vallum/sdk 0.0.0-prerelease

package/dist/requestSponsoredAction.js

@@ -0,0 +1,79 @@
+import { VallumAuthError, VallumError, VallumPolicyError } from "./errors.js";
+export async function requestSponsoredAction(options) {
+    const fetchImpl = options.fetchImpl ?? fetch;
+    const response = await fetchImpl(`${normalizeBaseUrl(options.baseUrl)}/v1/agent/sponsorships`, {
+        method: "POST",
+        headers: requestHeaders(options.apiKey),
+        body: JSON.stringify({
+            manifest: options.manifest,
+        }),
+    });
+    const json = await parseJson(response);
+    const result = parseSponsoredActionResult(json);
+    if (result)
+        return result;
+    if (!response.ok)
+        throw buildError(response.status, json);
+    throw new VallumError("Malformed Vallum response: missing sponsored action result.", undefined, json);
+}
+function normalizeBaseUrl(baseUrl) {
+    return baseUrl.replace(/\/+$/, "");
+}
+function requestHeaders(apiKey) {
+    const headers = {
+        "Content-Type": "application/json",
+    };
+    if (apiKey)
+        headers.Authorization = `Bearer ${apiKey}`;
+    return headers;
+}
+async function parseJson(response) {
+    return response.json().catch(() => ({}));
+}
+function parseSponsoredActionResult(value) {
+    const record = asRecord(value);
+    const decision = asRecord(record.decision);
+    if (record.approved === true &&
+        decision.allowed === true &&
+        typeof record.mockSponsorshipId === "string" &&
+        record.mockSponsorshipId.length > 0) {
+        return {
+            approved: true,
+            decision: { allowed: true },
+            mockSponsorshipId: record.mockSponsorshipId,
+        };
+    }
+    if (record.approved === false &&
+        decision.allowed === false &&
+        typeof decision.reasonCode === "string" &&
+        decision.reasonCode.length > 0 &&
+        typeof decision.message === "string") {
+        return {
+            approved: false,
+            decision: {
+                allowed: false,
+                reasonCode: decision.reasonCode,
+                message: decision.message,
+            },
+        };
+    }
+    return undefined;
+}
+function buildError(status, body) {
+    const record = asRecord(body);
+    const message = typeof record.message === "string"
+        ? record.message
+        : typeof record.error === "string"
+            ? record.error
+            : `Vallum request failed with HTTP ${status}`;
+    const reasonCode = typeof record.reasonCode === "string" ? record.reasonCode : undefined;
+    if (status === 401)
+        return new VallumAuthError(message, status, body);
+    if (status === 400 || status === 403 || status === 409 || status === 429) {
+        return new VallumPolicyError(message, reasonCode, status, body);
+    }
+    return new VallumError(message, status, body);
+}
+function asRecord(value) {
+    return typeof value === "object" && value !== null && !Array.isArray(value) ? value : {};
+}

package/dist/resolveAgent.d.ts

@@ -0,0 +1,5 @@
+import { type AgentResolver, type ResolveAgentResult } from "@vallum/registry";
+export interface ResolveAgentOptions {
+    readonly resolver: AgentResolver;
+}
+export declare function resolveAgent(name: string, options: ResolveAgentOptions): Promise<ResolveAgentResult>;

package/dist/resolveAgent.js

@@ -0,0 +1,4 @@
+import { resolveAgent as resolveRegistryAgent, } from "@vallum/registry";
+export function resolveAgent(name, options) {
+    return resolveRegistryAgent(name, options.resolver);
+}

package/dist/types.d.ts

@@ -0,0 +1,65 @@
+import type { PolicyDecision } from "@vallum/shared-types";
+import type { AgentTransactionManifest } from "@vallum/manifest";
+export interface VallumClientOptions {
+    baseUrl: string;
+    apiKey: string;
+    fetchImpl?: typeof fetch;
+}
+export interface ReserveGasRequest {
+    gasBudget: number;
+    reserveDurationSecs?: number;
+    walletAddress?: string;
+    packageId?: string;
+    functionName?: string;
+}
+export interface PolicySimulationRequest {
+    gasBudget?: number;
+    walletAddress?: string;
+    packageId?: string;
+    functionName?: string;
+}
+export type PolicySimulationResponse = PolicyDecision;
+export interface ReserveGasResponse {
+    reservationId: string;
+    agentRailTransactionId: string;
+    sponsorAddress?: string;
+    gasCoins?: unknown[];
+    raw: unknown;
+}
+export interface ExecuteSponsoredTransactionRequest {
+    reservationId: string;
+    agentRailTransactionId: string;
+    transactionBytes: string;
+    userSignature: string;
+}
+export interface ExecuteSponsoredTransactionResponse {
+    digest?: string;
+    raw: unknown;
+}
+export interface SponsoredActionRequest {
+    manifest: AgentTransactionManifest;
+}
+export interface RequestSponsoredActionOptions extends SponsoredActionRequest {
+    baseUrl: string;
+    apiKey?: string;
+    fetchImpl?: typeof fetch;
+}
+export type SponsoredActionDecision = {
+    allowed: true;
+} | {
+    allowed: false;
+    reasonCode: string;
+    message: string;
+};
+export type SponsoredActionResult = {
+    approved: true;
+    decision: Extract<SponsoredActionDecision, {
+        allowed: true;
+    }>;
+    mockSponsorshipId: string;
+} | {
+    approved: false;
+    decision: Extract<SponsoredActionDecision, {
+        allowed: false;
+    }>;
+};

package/dist/types.js

@@ -0,0 +1 @@
+export {};

package/package.json

@@ -0,0 +1,41 @@
+{
+  "name": "@vallum/sdk",
+  "version": "0.0.0-prerelease",
+  "type": "module",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "license": "Apache-2.0",
+  "dependencies": {
+    "@vallum/manifest": "0.0.0-prerelease",
+    "@vallum/registry": "0.0.0-prerelease",
+    "@vallum/receipts": "0.0.0-prerelease",
+    "@vallum/shared-types": "0.0.0-prerelease"
+  },
+  "devDependencies": {
+    "@vallum/policy-gateway": "0.0.0-prerelease"
+  },
+  "description": "TypeScript SDK scaffold for Vallum sponsorship gateways.",
+  "files": [
+    "dist/**/*.js",
+    "dist/**/*.d.ts",
+    "LICENSE",
+    "README.md"
+  ],
+  "sideEffects": false,
+  "scripts": {
+    "build": "tsc -p tsconfig.build.json"
+  },
+  "engines": {
+    "node": ">=20"
+  },
+  "publishConfig": {
+    "access": "public",
+    "tag": "next"
+  }
+}