@orth/sdk 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Orthogonal
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,54 @@
+# @orth/sdk
+
+TypeScript SDK to call any API on the Orthogonal platform.
+
+## Installation
+
+```bash
+npm install @orth/sdk
+```
+
+## Quick Start
+
+```typescript
+import Orthogonal from "@orth/sdk";
+
+const orthogonal = new Orthogonal({
+  apiKey: process.env.ORTHOGONAL_API_KEY,
+});
+
+const response = await orthogonal.run({
+  api: "andi",
+  path: "/api/v1/search",
+  query: { q: "what is the weather today" },
+});
+
+console.log(response.data);
+console.log(response.price); // e.g., "0.01"
+```
+
+## Response
+
+### Success
+
+```json
+{
+  "success": true,
+  "price": "0.01",
+  "data": { ... }
+}
+```
+
+### Error
+
+```json
+{
+  "success": false,
+  "price": "0",
+  "error": "API my-api not found or not active"
+}
+```
+
+## License
+
+MIT

package/dist/index.d.mts

@@ -0,0 +1,62 @@
+/**
+ * Configuration options for the Orthogonal client
+ */
+interface OrthogonalConfig {
+    /** Your Orthogonal API key (starts with orth_live_ or orth_test_) */
+    apiKey: string;
+}
+/**
+ * Options for the run() method
+ */
+interface RunOptions {
+    /** The API slug (e.g., "andi", "weather-api") */
+    api: string;
+    /** The endpoint path (e.g., "/api/v1/search") */
+    path: string;
+    /** Query parameters to pass to the endpoint */
+    query?: Record<string, unknown>;
+    /** Request body for POST/PUT/PATCH requests */
+    body?: Record<string, unknown>;
+}
+/**
+ * Response from the run() method
+ */
+interface RunResponse {
+    /** Whether the request was successful */
+    success: boolean;
+    /** The price paid in USD (e.g., "0.01") */
+    price: string;
+    /** The response data from the target API */
+    data: unknown;
+}
+
+/**
+ * Orthogonal SDK client
+ *
+ * @example
+ * ```typescript
+ * import Orthogonal from "@orth/sdk";
+ *
+ * const orthogonal = new Orthogonal({
+ *   apiKey: process.env.ORTHOGONAL_API_KEY
+ * });
+ *
+ * const response = await orthogonal.run({
+ *   api: "andi",
+ *   path: "/api/v1/search",
+ *   query: { q: "hello world" }
+ * });
+ *
+ * console.log(response.data);
+ * ```
+ */
+declare class Orthogonal {
+    private apiKey;
+    constructor(config: OrthogonalConfig);
+    /**
+     * Call any API on the Orthogonal platform
+     */
+    run(options: RunOptions): Promise<RunResponse>;
+}
+
+export { Orthogonal, type OrthogonalConfig, type RunOptions, type RunResponse, Orthogonal as default };

package/dist/index.d.ts

@@ -0,0 +1,62 @@
+/**
+ * Configuration options for the Orthogonal client
+ */
+interface OrthogonalConfig {
+    /** Your Orthogonal API key (starts with orth_live_ or orth_test_) */
+    apiKey: string;
+}
+/**
+ * Options for the run() method
+ */
+interface RunOptions {
+    /** The API slug (e.g., "andi", "weather-api") */
+    api: string;
+    /** The endpoint path (e.g., "/api/v1/search") */
+    path: string;
+    /** Query parameters to pass to the endpoint */
+    query?: Record<string, unknown>;
+    /** Request body for POST/PUT/PATCH requests */
+    body?: Record<string, unknown>;
+}
+/**
+ * Response from the run() method
+ */
+interface RunResponse {
+    /** Whether the request was successful */
+    success: boolean;
+    /** The price paid in USD (e.g., "0.01") */
+    price: string;
+    /** The response data from the target API */
+    data: unknown;
+}
+
+/**
+ * Orthogonal SDK client
+ *
+ * @example
+ * ```typescript
+ * import Orthogonal from "@orth/sdk";
+ *
+ * const orthogonal = new Orthogonal({
+ *   apiKey: process.env.ORTHOGONAL_API_KEY
+ * });
+ *
+ * const response = await orthogonal.run({
+ *   api: "andi",
+ *   path: "/api/v1/search",
+ *   query: { q: "hello world" }
+ * });
+ *
+ * console.log(response.data);
+ * ```
+ */
+declare class Orthogonal {
+    private apiKey;
+    constructor(config: OrthogonalConfig);
+    /**
+     * Call any API on the Orthogonal platform
+     */
+    run(options: RunOptions): Promise<RunResponse>;
+}
+
+export { Orthogonal, type OrthogonalConfig, type RunOptions, type RunResponse, Orthogonal as default };

package/dist/index.js

@@ -0,0 +1,69 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/index.ts
+var index_exports = {};
+__export(index_exports, {
+  Orthogonal: () => Orthogonal,
+  default: () => index_default
+});
+module.exports = __toCommonJS(index_exports);
+var VERSION = "0.1.0";
+var BASE_URL = "https://api.orth.sh";
+var Orthogonal = class {
+  constructor(config) {
+    if (!config.apiKey) {
+      throw new Error("Orthogonal API key is required");
+    }
+    this.apiKey = config.apiKey;
+  }
+  /**
+   * Call any API on the Orthogonal platform
+   */
+  async run(options) {
+    const { api, path, query, body } = options;
+    const response = await fetch(`${BASE_URL}/v1/run`, {
+      method: "POST",
+      headers: {
+        Authorization: `Bearer ${this.apiKey}`,
+        "Content-Type": "application/json",
+        "User-Agent": `@orth/sdk/${VERSION}`
+      },
+      body: JSON.stringify({ api, path, query, body })
+    });
+    const data = await response.json();
+    if (!response.ok) {
+      if (response.status === 401) {
+        throw new Error("Invalid API key. Visit https://orthogonal.sh to get one!");
+      }
+      if (response.status === 402) {
+        throw new Error("Insufficient funds. Add USDC at https://orthogonal.sh");
+      }
+      const errorMessage = data.data?.error || data.error || `Request failed with status ${response.status}`;
+      throw new Error(errorMessage);
+    }
+    return data;
+  }
+};
+var index_default = Orthogonal;
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  Orthogonal
+});
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/index.ts"],"sourcesContent":["import { OrthogonalConfig, RunOptions, RunResponse } from \"./types\";\n\nconst VERSION = \"0.1.0\";\nconst BASE_URL = \"https://api.orth.sh\";\n\n/**\n * Orthogonal SDK client\n *\n * @example\n * ```typescript\n * import Orthogonal from \"@orth/sdk\";\n *\n * const orthogonal = new Orthogonal({\n *   apiKey: process.env.ORTHOGONAL_API_KEY\n * });\n *\n * const response = await orthogonal.run({\n *   api: \"andi\",\n *   path: \"/api/v1/search\",\n *   query: { q: \"hello world\" }\n * });\n *\n * console.log(response.data);\n * ```\n */\nexport class Orthogonal {\n  private apiKey: string;\n\n  constructor(config: OrthogonalConfig) {\n    if (!config.apiKey) {\n      throw new Error(\"Orthogonal API key is required\");\n    }\n    this.apiKey = config.apiKey;\n  }\n\n  /**\n   * Call any API on the Orthogonal platform\n   */\n  async run(options: RunOptions): Promise<RunResponse> {\n    const { api, path, query, body } = options;\n\n    const response = await fetch(`${BASE_URL}/v1/run`, {\n      method: \"POST\",\n      headers: {\n        Authorization: `Bearer ${this.apiKey}`,\n        \"Content-Type\": \"application/json\",\n        \"User-Agent\": `@orth/sdk/${VERSION}`,\n      },\n      body: JSON.stringify({ api, path, query, body }),\n    });\n\n    const data = await response.json();\n\n    if (!response.ok) {\n      // Provide helpful error messages for common cases\n      if (response.status === 401) {\n        throw new Error(\"Invalid API key. Visit https://orthogonal.sh to get one!\");\n      }\n      if (response.status === 402) {\n        throw new Error(\"Insufficient funds. Add USDC at https://orthogonal.sh\");\n      }\n      // Check for nested error in data.error (e.g., from target API)\n      const errorMessage = data.data?.error || data.error || `Request failed with status ${response.status}`;\n      throw new Error(errorMessage);\n    }\n\n    return data as RunResponse;\n  }\n}\n\n// Export types\nexport * from \"./types\";\n\n// Default export\nexport default Orthogonal;\n"],"mappings":";;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAEA,IAAM,UAAU;AAChB,IAAM,WAAW;AAsBV,IAAM,aAAN,MAAiB;AAAA,EAGtB,YAAY,QAA0B;AACpC,QAAI,CAAC,OAAO,QAAQ;AAClB,YAAM,IAAI,MAAM,gCAAgC;AAAA,IAClD;AACA,SAAK,SAAS,OAAO;AAAA,EACvB;AAAA;AAAA;AAAA;AAAA,EAKA,MAAM,IAAI,SAA2C;AACnD,UAAM,EAAE,KAAK,MAAM,OAAO,KAAK,IAAI;AAEnC,UAAM,WAAW,MAAM,MAAM,GAAG,QAAQ,WAAW;AAAA,MACjD,QAAQ;AAAA,MACR,SAAS;AAAA,QACP,eAAe,UAAU,KAAK,MAAM;AAAA,QACpC,gBAAgB;AAAA,QAChB,cAAc,aAAa,OAAO;AAAA,MACpC;AAAA,MACA,MAAM,KAAK,UAAU,EAAE,KAAK,MAAM,OAAO,KAAK,CAAC;AAAA,IACjD,CAAC;AAED,UAAM,OAAO,MAAM,SAAS,KAAK;AAEjC,QAAI,CAAC,SAAS,IAAI;AAEhB,UAAI,SAAS,WAAW,KAAK;AAC3B,cAAM,IAAI,MAAM,0DAA0D;AAAA,MAC5E;AACA,UAAI,SAAS,WAAW,KAAK;AAC3B,cAAM,IAAI,MAAM,uDAAuD;AAAA,MACzE;AAEA,YAAM,eAAe,KAAK,MAAM,SAAS,KAAK,SAAS,8BAA8B,SAAS,MAAM;AACpG,YAAM,IAAI,MAAM,YAAY;AAAA,IAC9B;AAEA,WAAO;AAAA,EACT;AACF;AAMA,IAAO,gBAAQ;","names":[]}

package/dist/index.mjs

@@ -0,0 +1,44 @@
+// src/index.ts
+var VERSION = "0.1.0";
+var BASE_URL = "https://api.orth.sh";
+var Orthogonal = class {
+  constructor(config) {
+    if (!config.apiKey) {
+      throw new Error("Orthogonal API key is required");
+    }
+    this.apiKey = config.apiKey;
+  }
+  /**
+   * Call any API on the Orthogonal platform
+   */
+  async run(options) {
+    const { api, path, query, body } = options;
+    const response = await fetch(`${BASE_URL}/v1/run`, {
+      method: "POST",
+      headers: {
+        Authorization: `Bearer ${this.apiKey}`,
+        "Content-Type": "application/json",
+        "User-Agent": `@orth/sdk/${VERSION}`
+      },
+      body: JSON.stringify({ api, path, query, body })
+    });
+    const data = await response.json();
+    if (!response.ok) {
+      if (response.status === 401) {
+        throw new Error("Invalid API key. Visit https://orthogonal.sh to get one!");
+      }
+      if (response.status === 402) {
+        throw new Error("Insufficient funds. Add USDC at https://orthogonal.sh");
+      }
+      const errorMessage = data.data?.error || data.error || `Request failed with status ${response.status}`;
+      throw new Error(errorMessage);
+    }
+    return data;
+  }
+};
+var index_default = Orthogonal;
+export {
+  Orthogonal,
+  index_default as default
+};
+//# sourceMappingURL=index.mjs.map

package/dist/index.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/index.ts"],"sourcesContent":["import { OrthogonalConfig, RunOptions, RunResponse } from \"./types\";\n\nconst VERSION = \"0.1.0\";\nconst BASE_URL = \"https://api.orth.sh\";\n\n/**\n * Orthogonal SDK client\n *\n * @example\n * ```typescript\n * import Orthogonal from \"@orth/sdk\";\n *\n * const orthogonal = new Orthogonal({\n *   apiKey: process.env.ORTHOGONAL_API_KEY\n * });\n *\n * const response = await orthogonal.run({\n *   api: \"andi\",\n *   path: \"/api/v1/search\",\n *   query: { q: \"hello world\" }\n * });\n *\n * console.log(response.data);\n * ```\n */\nexport class Orthogonal {\n  private apiKey: string;\n\n  constructor(config: OrthogonalConfig) {\n    if (!config.apiKey) {\n      throw new Error(\"Orthogonal API key is required\");\n    }\n    this.apiKey = config.apiKey;\n  }\n\n  /**\n   * Call any API on the Orthogonal platform\n   */\n  async run(options: RunOptions): Promise<RunResponse> {\n    const { api, path, query, body } = options;\n\n    const response = await fetch(`${BASE_URL}/v1/run`, {\n      method: \"POST\",\n      headers: {\n        Authorization: `Bearer ${this.apiKey}`,\n        \"Content-Type\": \"application/json\",\n        \"User-Agent\": `@orth/sdk/${VERSION}`,\n      },\n      body: JSON.stringify({ api, path, query, body }),\n    });\n\n    const data = await response.json();\n\n    if (!response.ok) {\n      // Provide helpful error messages for common cases\n      if (response.status === 401) {\n        throw new Error(\"Invalid API key. Visit https://orthogonal.sh to get one!\");\n      }\n      if (response.status === 402) {\n        throw new Error(\"Insufficient funds. Add USDC at https://orthogonal.sh\");\n      }\n      // Check for nested error in data.error (e.g., from target API)\n      const errorMessage = data.data?.error || data.error || `Request failed with status ${response.status}`;\n      throw new Error(errorMessage);\n    }\n\n    return data as RunResponse;\n  }\n}\n\n// Export types\nexport * from \"./types\";\n\n// Default export\nexport default Orthogonal;\n"],"mappings":";AAEA,IAAM,UAAU;AAChB,IAAM,WAAW;AAsBV,IAAM,aAAN,MAAiB;AAAA,EAGtB,YAAY,QAA0B;AACpC,QAAI,CAAC,OAAO,QAAQ;AAClB,YAAM,IAAI,MAAM,gCAAgC;AAAA,IAClD;AACA,SAAK,SAAS,OAAO;AAAA,EACvB;AAAA;AAAA;AAAA;AAAA,EAKA,MAAM,IAAI,SAA2C;AACnD,UAAM,EAAE,KAAK,MAAM,OAAO,KAAK,IAAI;AAEnC,UAAM,WAAW,MAAM,MAAM,GAAG,QAAQ,WAAW;AAAA,MACjD,QAAQ;AAAA,MACR,SAAS;AAAA,QACP,eAAe,UAAU,KAAK,MAAM;AAAA,QACpC,gBAAgB;AAAA,QAChB,cAAc,aAAa,OAAO;AAAA,MACpC;AAAA,MACA,MAAM,KAAK,UAAU,EAAE,KAAK,MAAM,OAAO,KAAK,CAAC;AAAA,IACjD,CAAC;AAED,UAAM,OAAO,MAAM,SAAS,KAAK;AAEjC,QAAI,CAAC,SAAS,IAAI;AAEhB,UAAI,SAAS,WAAW,KAAK;AAC3B,cAAM,IAAI,MAAM,0DAA0D;AAAA,MAC5E;AACA,UAAI,SAAS,WAAW,KAAK;AAC3B,cAAM,IAAI,MAAM,uDAAuD;AAAA,MACzE;AAEA,YAAM,eAAe,KAAK,MAAM,SAAS,KAAK,SAAS,8BAA8B,SAAS,MAAM;AACpG,YAAM,IAAI,MAAM,YAAY;AAAA,IAC9B;AAEA,WAAO;AAAA,EACT;AACF;AAMA,IAAO,gBAAQ;","names":[]}

package/package.json

@@ -0,0 +1,51 @@
+{
+  "name": "@orth/sdk",
+  "version": "0.1.0",
+  "description": "TypeScript SDK to call any API on the Orthogonal platform",
+  "main": "dist/index.js",
+  "module": "dist/index.mjs",
+  "types": "dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.mjs",
+      "require": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "sideEffects": false,
+  "scripts": {
+    "build": "tsup",
+    "test": "vitest",
+    "prepublishOnly": "npm run build"
+  },
+  "keywords": [
+    "orthogonal",
+    "api",
+    "sdk",
+    "x402",
+    "payments",
+    "ai-agents"
+  ],
+  "author": "Orthogonal <founders@orthogonal.sh> (https://orthogonal.sh)",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/orthogonal-sh/orthogonal-typescript.git"
+  },
+  "homepage": "https://orthogonal.sh",
+  "bugs": {
+    "url": "https://github.com/orthogonal-sh/orthogonal-typescript/issues"
+  },
+  "engines": {
+    "node": ">=18"
+  },
+  "devDependencies": {
+    "tsup": "^8.0.0",
+    "tsx": "^4.21.0",
+    "typescript": "^5.0.0",
+    "vitest": "^1.0.0"
+  }
+}