@compose-market/sdk 0.1.0 → 0.1.1

package/README.md

@@ -0,0 +1,63 @@
+# `@compose-market/sdk`
+
+Official Compose.Market SDK for wallet-tied Compose keys, x402 facilitator access, model discovery, and unified inference APIs.
+
+## Install
+
+```bash
+npm install @compose-market/sdk
+```
+
+## Quick start
+
+```ts
+import { ComposeSDK, ComposePaymentRequiredError } from "@compose-market/sdk";
+
+const sdk = new ComposeSDK();
+
+await sdk.wallets.attach({
+  address: "0x1234567890abcdef1234567890abcdef12345678",
+  chainId: 84532,
+});
+
+const session = await sdk.keys.create({
+  purpose: "session",
+  budgetUsd: 5,
+  durationHours: 2,
+  name: "demo-session",
+});
+
+sdk.keys.use(session.token);
+
+const models = await sdk.models.list();
+
+try {
+  const response = await sdk.inference.responses.create({
+    model: "gpt-4.1-mini",
+    input: [{ type: "input_text", text: "Say hello." }],
+    modalities: ["text"],
+  });
+
+  console.log(response);
+} catch (error) {
+  if (error instanceof ComposePaymentRequiredError) {
+    console.log(error.paymentRequired);
+  }
+  throw error;
+}
+```
+
+## Main capabilities
+
+- Attach a wallet or smart-account context through the same header contract used by Compose.Market apps.
+- Create, list, revoke, and activate Compose keys for both session and API usage.
+- Discover the full model catalog, per-model parameter schemas, and pricing data.
+- Call Compose inference endpoints through Responses, Chat Completions, Images, Audio, Embeddings, and Video APIs.
+- Decode and work with x402 `PAYMENT-REQUIRED` negotiation details.
+- Call Compose facilitator `supported`, `verify`, and `settle` endpoints directly.
+
+## Notes
+
+- The SDK is runtime-neutral and works in modern Node.js and browser environments with a standards-compliant `fetch`.
+- The core package does not bundle a wallet SDK. External apps can attach any already-known wallet or smart-account address and chain context.
+- Session key creation requires the tied wallet or smart account to already have enough USDC balance and allowance for the requested budget on the selected chain. If not, the SDK throws a `ComposeApiError` with status `402`.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@compose-market/sdk",
-  "version": "0.1.0",
+  "version": "0.1.1",
   "description": "Official Compose.Market SDK for Compose keys, x402 facilitator access, model discovery, and inference APIs.",
   "keywords": [
     "x402",
@@ -36,82 +36,13 @@
     "index.js",
     "index.d.ts"
   ],
+  "sideEffects": false,
   "scripts": {
     "clean": "rm -f index.js index.d.ts",
     "build": "npm run clean && tsc -p tsconfig.json",
     "test": "npm run build && node --import tsx --test tests/**/*.test.ts",
     "typecheck": "tsc --noEmit -p tsconfig.json"
   },
-  "dependencies": {
-    "accepts": "^2.0.0",
-    "body-parser": "^2.2.2",
-    "bytes": "^3.1.2",
-    "call-bind-apply-helpers": "^1.0.2",
-    "call-bound": "^1.0.4",
-    "content-disposition": "^1.1.0",
-    "content-type": "^1.0.5",
-    "cookie": "^0.7.2",
-    "cookie-signature": "^1.2.2",
-    "debug": "^4.4.3",
-    "depd": "^2.0.0",
-    "dunder-proto": "^1.0.1",
-    "ee-first": "^1.1.1",
-    "encodeurl": "^2.0.0",
-    "es-define-property": "^1.0.1",
-    "es-errors": "^1.3.0",
-    "es-object-atoms": "^1.1.1",
-    "esbuild": "^0.27.7",
-    "escape-html": "^1.0.3",
-    "etag": "^1.8.1",
-    "finalhandler": "^2.1.1",
-    "forwarded": "^0.2.0",
-    "fresh": "^2.0.0",
-    "function-bind": "^1.1.2",
-    "get-intrinsic": "^1.3.0",
-    "get-proto": "^1.0.1",
-    "get-tsconfig": "^4.14.0",
-    "gopd": "^1.2.0",
-    "has-symbols": "^1.1.0",
-    "hasown": "^2.0.3",
-    "http-errors": "^2.0.1",
-    "iconv-lite": "^0.7.2",
-    "inherits": "^2.0.4",
-    "ipaddr.js": "^1.9.1",
-    "is-promise": "^4.0.0",
-    "math-intrinsics": "^1.1.0",
-    "media-typer": "^1.1.0",
-    "merge-descriptors": "^2.0.0",
-    "mime-db": "^1.54.0",
-    "mime-types": "^3.0.2",
-    "ms": "^2.1.3",
-    "negotiator": "^1.0.0",
-    "object-inspect": "^1.13.4",
-    "on-finished": "^2.4.1",
-    "once": "^1.4.0",
-    "parseurl": "^1.3.3",
-    "path-to-regexp": "^8.4.2",
-    "proxy-addr": "^2.0.7",
-    "qs": "^6.15.1",
-    "range-parser": "^1.2.1",
-    "raw-body": "^3.0.2",
-    "resolve-pkg-maps": "^1.0.0",
-    "router": "^2.2.0",
-    "safer-buffer": "^2.1.2",
-    "send": "^1.2.1",
-    "serve-static": "^2.2.1",
-    "setprototypeof": "^1.2.0",
-    "side-channel": "^1.1.0",
-    "side-channel-list": "^1.0.1",
-    "side-channel-map": "^1.0.1",
-    "side-channel-weakmap": "^1.0.2",
-    "statuses": "^2.0.2",
-    "toidentifier": "^1.0.1",
-    "type-is": "^2.0.1",
-    "undici-types": "^7.19.2",
-    "unpipe": "^1.0.0",
-    "vary": "^1.1.2",
-    "wrappy": "^1.0.2"
-  },
   "devDependencies": {
     "@types/express": "^5.0.6",
     "@types/node": "^25.6.0",
@@ -123,4 +54,4 @@
     "access": "public"
   },
   "module": "./index.js"
-}
+}