@orbserv-labs/orb-wallet 0.1.0

package/dist/utils/errors.js

@@ -0,0 +1,44 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.OrbAuthError = exports.OrbApiError = exports.OrbError = void 0;
+/**
+ * Base error class for all orb-wallet SDK errors.
+ */
+class OrbError extends Error {
+    constructor(message) {
+        super(message);
+        this.name = "OrbError";
+        // Maintain proper prototype chain in transpiled ES5+
+        Object.setPrototypeOf(this, new.target.prototype);
+    }
+}
+exports.OrbError = OrbError;
+/**
+ * Thrown when the API returns a non-2xx response.
+ * Contains the HTTP status code and the raw response body.
+ */
+class OrbApiError extends OrbError {
+    constructor(statusCode, body) {
+        const message = typeof body === "object" && body !== null && "message" in body
+            ? String(body.message)
+            : `API error ${statusCode}`;
+        super(message);
+        this.name = "OrbApiError";
+        this.statusCode = statusCode;
+        this.body = body;
+        Object.setPrototypeOf(this, new.target.prototype);
+    }
+}
+exports.OrbApiError = OrbApiError;
+/**
+ * Thrown when the request fails due to authentication issues (401 / 403).
+ */
+class OrbAuthError extends OrbApiError {
+    constructor(statusCode, body) {
+        super(statusCode, body);
+        this.name = "OrbAuthError";
+        Object.setPrototypeOf(this, new.target.prototype);
+    }
+}
+exports.OrbAuthError = OrbAuthError;
+//# sourceMappingURL=errors.js.map

package/dist/utils/errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../../src/utils/errors.ts"],"names":[],"mappings":";;;AAAA;;GAEG;AACH,MAAa,QAAS,SAAQ,KAAK;IACjC,YAAY,OAAe;QACzB,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,UAAU,CAAC;QACvB,qDAAqD;QACrD,MAAM,CAAC,cAAc,CAAC,IAAI,EAAE,GAAG,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC;IACpD,CAAC;CACF;AAPD,4BAOC;AAED;;;GAGG;AACH,MAAa,WAAY,SAAQ,QAAQ;IAIvC,YAAY,UAAkB,EAAE,IAAa;QAC3C,MAAM,OAAO,GACX,OAAO,IAAI,KAAK,QAAQ,IAAI,IAAI,KAAK,IAAI,IAAI,SAAS,IAAI,IAAI;YAC5D,CAAC,CAAC,MAAM,CAAE,IAAgC,CAAC,OAAO,CAAC;YACnD,CAAC,CAAC,aAAa,UAAU,EAAE,CAAC;QAChC,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,aAAa,CAAC;QAC1B,IAAI,CAAC,UAAU,GAAG,UAAU,CAAC;QAC7B,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;QACjB,MAAM,CAAC,cAAc,CAAC,IAAI,EAAE,GAAG,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC;IACpD,CAAC;CACF;AAfD,kCAeC;AAED;;GAEG;AACH,MAAa,YAAa,SAAQ,WAAW;IAC3C,YAAY,UAAkB,EAAE,IAAa;QAC3C,KAAK,CAAC,UAAU,EAAE,IAAI,CAAC,CAAC;QACxB,IAAI,CAAC,IAAI,GAAG,cAAc,CAAC;QAC3B,MAAM,CAAC,cAAc,CAAC,IAAI,EAAE,GAAG,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC;IACpD,CAAC;CACF;AAND,oCAMC"}

package/dist/utils/http.d.ts

@@ -0,0 +1,35 @@
+/**
+ * Lightweight HTTP client that attaches the Bearer token and handles errors.
+ * Uses the global `fetch` (Node 18+, browsers). No runtime dependencies.
+ */
+export declare class HttpClient {
+    private readonly baseUrl;
+    private readonly apiKey;
+    constructor(baseUrl: string, apiKey: string);
+    private buildUrl;
+    private headers;
+    private handleResponse;
+    /**
+     * Perform a GET request.
+     * @param path - API path relative to baseUrl, e.g. `/wallets/abc`
+     */
+    get<T>(path: string): Promise<T>;
+    /**
+     * Perform a POST request with a JSON body.
+     */
+    post<T>(path: string, body?: unknown): Promise<T>;
+    /**
+     * Perform a PATCH request with a JSON body.
+     */
+    patch<T>(path: string, body?: unknown): Promise<T>;
+    /**
+     * Perform a DELETE request.
+     */
+    delete<T>(path: string): Promise<T>;
+    /**
+     * Perform an arbitrary fetch, forwarding the Authorization header.
+     * Used by `wallet.fetch()` for x402 auto-pay flows.
+     */
+    proxyFetch(url: string, init?: RequestInit): Promise<Response>;
+}
+//# sourceMappingURL=http.d.ts.map

package/dist/utils/http.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"http.d.ts","sourceRoot":"","sources":["../../src/utils/http.ts"],"names":[],"mappings":"AAEA;;;GAGG;AACH,qBAAa,UAAU;IACrB,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAS;IACjC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAS;gBAEpB,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM;IAS3C,OAAO,CAAC,QAAQ;IAIhB,OAAO,CAAC,OAAO;YAQD,cAAc;IA0B5B;;;OAGG;IACG,GAAG,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,CAAC,CAAC;IAQtC;;OAEG;IACG,IAAI,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,OAAO,GAAG,OAAO,CAAC,CAAC,CAAC;IASvD;;OAEG;IACG,KAAK,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,OAAO,GAAG,OAAO,CAAC,CAAC,CAAC;IASxD;;OAEG;IACG,MAAM,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,CAAC,CAAC;IAQzC;;;OAGG;IACG,UAAU,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,QAAQ,CAAC;CAOrE"}

package/dist/utils/http.js

@@ -0,0 +1,105 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.HttpClient = void 0;
+const errors_js_1 = require("./errors.js");
+/**
+ * Lightweight HTTP client that attaches the Bearer token and handles errors.
+ * Uses the global `fetch` (Node 18+, browsers). No runtime dependencies.
+ */
+class HttpClient {
+    constructor(baseUrl, apiKey) {
+        this.baseUrl = baseUrl.replace(/\/$/, ""); // strip trailing slash
+        this.apiKey = apiKey;
+    }
+    // -------------------------------------------------------------------------
+    // Private helpers
+    // -------------------------------------------------------------------------
+    buildUrl(path) {
+        return `${this.baseUrl}${path.startsWith("/") ? path : `/${path}`}`;
+    }
+    headers(extra) {
+        return {
+            "Content-Type": "application/json",
+            Authorization: `Bearer ${this.apiKey}`,
+            ...extra,
+        };
+    }
+    async handleResponse(response) {
+        let body;
+        const contentType = response.headers.get("content-type") ?? "";
+        try {
+            body = contentType.includes("application/json")
+                ? await response.json()
+                : await response.text();
+        }
+        catch {
+            body = null;
+        }
+        if (!response.ok) {
+            if (response.status === 401 || response.status === 403) {
+                throw new errors_js_1.OrbAuthError(response.status, body);
+            }
+            throw new errors_js_1.OrbApiError(response.status, body);
+        }
+        return body;
+    }
+    // -------------------------------------------------------------------------
+    // Public HTTP verbs
+    // -------------------------------------------------------------------------
+    /**
+     * Perform a GET request.
+     * @param path - API path relative to baseUrl, e.g. `/wallets/abc`
+     */
+    async get(path) {
+        const response = await fetch(this.buildUrl(path), {
+            method: "GET",
+            headers: this.headers(),
+        });
+        return this.handleResponse(response);
+    }
+    /**
+     * Perform a POST request with a JSON body.
+     */
+    async post(path, body) {
+        const response = await fetch(this.buildUrl(path), {
+            method: "POST",
+            headers: this.headers(),
+            body: body !== undefined ? JSON.stringify(body) : undefined,
+        });
+        return this.handleResponse(response);
+    }
+    /**
+     * Perform a PATCH request with a JSON body.
+     */
+    async patch(path, body) {
+        const response = await fetch(this.buildUrl(path), {
+            method: "PATCH",
+            headers: this.headers(),
+            body: body !== undefined ? JSON.stringify(body) : undefined,
+        });
+        return this.handleResponse(response);
+    }
+    /**
+     * Perform a DELETE request.
+     */
+    async delete(path) {
+        const response = await fetch(this.buildUrl(path), {
+            method: "DELETE",
+            headers: this.headers(),
+        });
+        return this.handleResponse(response);
+    }
+    /**
+     * Perform an arbitrary fetch, forwarding the Authorization header.
+     * Used by `wallet.fetch()` for x402 auto-pay flows.
+     */
+    async proxyFetch(url, init) {
+        const mergedHeaders = {
+            ...this.headers(),
+            ...init?.headers,
+        };
+        return fetch(url, { ...init, headers: mergedHeaders });
+    }
+}
+exports.HttpClient = HttpClient;
+//# sourceMappingURL=http.js.map

package/dist/utils/http.js.map

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

package/package.json

@@ -0,0 +1,52 @@
+{
+  "name": "@orbserv-labs/orb-wallet",
+  "version": "0.1.0",
+  "description": "TypeScript SDK for the orbserv agent wallet API — multi-chain wallets, x402 auto-pay, and spending policies for AI agents",
+  "keywords": [
+    "wallet",
+    "agent-wallet",
+    "x402",
+    "solana",
+    "base",
+    "ethereum",
+    "arbitrum",
+    "usdc",
+    "ai-agent",
+    "orbserv"
+  ],
+  "homepage": "https://orbserv.co",
+  "license": "MIT",
+  "author": "orbserv Labs",
+  "main": "./dist/index.js",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "default": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "scripts": {
+    "build": "tsc -p tsconfig.build.json",
+    "build:cjs": "tsc -p tsconfig.build.json --module commonjs --outDir dist/cjs",
+    "dev": "tsc --watch",
+    "lint": "tsc --noEmit",
+    "prepublishOnly": "npm run lint && npm run build",
+    "clean": "rm -rf dist"
+  },
+  "engines": {
+    "node": ">=18.0.0"
+  },
+  "devDependencies": {
+    "@types/node": "^20.19.41",
+    "typescript": "^5.9.3"
+  }
+}