@x402jobs/sdk 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2024 x402jobs
+
+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,144 @@
+# @x402jobs/sdk
+
+The official SDK for [x402.jobs](https://x402.jobs) — trust, discovery, and resource management for the x402 ecosystem.
+
+## Install
+
+```bash
+npm install @x402jobs/sdk
+```
+
+## Quick Start
+
+### Check if a resource is reliable
+
+```javascript
+import { check } from '@x402jobs/sdk'
+
+const score = await check('https://api.example.com/resource')
+// {
+//   url: "https://api.example.com/resource",
+//   success_rate: 0.94,
+//   calls: 1240,
+//   value_processed: "$12.4k",
+//   last_called: "2m ago"
+// }
+```
+
+### Browse top resources
+
+```javascript
+import { check } from '@x402jobs/sdk'
+
+const top = await check.top({ limit: 20 })
+```
+
+### Search resources
+
+```javascript
+import { resources } from '@x402jobs/sdk'
+
+const results = await resources.search({
+  query: 'image generation',
+  minSuccessRate: 0.9
+})
+```
+
+### Register your resource
+
+```javascript
+import { resources, configure } from '@x402jobs/sdk'
+
+configure({ apiKey: 'your-api-key' })
+
+await resources.register({
+  url: 'https://my-api.com/endpoint',
+  name: 'My API',
+  price: '$0.01'
+})
+```
+
+## Why?
+
+You can index x402 endpoints all day. Doesn't mean they work.
+
+x402jobs gives you reliability scores backed by real paid usage — not synthetic pings.
+
+We ran the transactions. We paid the fees. Now you get the data.
+
+## API Reference
+
+### Trust / Verification
+
+| Function | Description |
+|----------|-------------|
+| `check(url)` | Get reliability score for a resource |
+| `check.many(urls)` | Check multiple resources |
+| `check.exists(url)` | Check if resource is indexed |
+| `check.top(options)` | Get top-ranked resources |
+
+### Resources
+
+| Function | Description |
+|----------|-------------|
+| `resources.list()` | Get all resources |
+| `resources.get(url)` | Get single resource |
+| `resources.search(options)` | Search resources |
+| `resources.register(input)` | Register new resource |
+| `resources.update(id, input)` | Update resource |
+| `resources.delete(id)` | Delete resource |
+
+### Configuration
+
+| Function | Description |
+|----------|-------------|
+| `configure({ apiKey })` | Set API key for unlimited access |
+| `configure({ baseUrl })` | Set custom API URL |
+
+## Error Handling
+
+```javascript
+import { X402Error } from '@x402jobs/sdk'
+
+try {
+  const score = await check(url)
+} catch (err) {
+  if (err instanceof X402Error) {
+    console.log(err.code)     // Error code
+    console.log(err.message)  // Human readable
+    console.log(err.status)   // HTTP status
+  }
+}
+```
+
+### Error Codes
+
+| Code | Description |
+|------|-------------|
+| `NOT_FOUND` | Resource not indexed |
+| `PAYMENT_REQUIRED` | x402 payment failed |
+| `RATE_LIMITED` | Too many requests |
+| `UNAUTHORIZED` | Invalid or missing API key |
+| `FORBIDDEN` | Not allowed |
+| `VALIDATION_ERROR` | Invalid input |
+| `SERVER_ERROR` | x402jobs API error |
+
+## TypeScript
+
+Full TypeScript support with exported types:
+
+```typescript
+import type {
+  Score,
+  Resource,
+  ResourceSearchOptions
+} from '@x402jobs/sdk'
+```
+
+## Docs
+
+Full documentation at [x402.jobs/docs](https://x402.jobs/docs)
+
+## License
+
+MIT

package/dist/index.d.mts

@@ -0,0 +1,106 @@
+interface Score {
+    url: string;
+    success_rate: number | null;
+    calls: number;
+    value_processed: string;
+    last_called: string | null;
+}
+interface TopOptions {
+    limit?: number;
+    category?: string;
+}
+interface Resource {
+    id: string;
+    url: string;
+    name: string;
+    description: string;
+    icon_url: string | null;
+    category: string;
+    price: string;
+    owner_id: string;
+    created_at: string;
+    updated_at: string;
+    success_rate: number | null;
+    calls: number;
+    value_processed: string;
+    last_called: string | null;
+}
+interface ResourceSearchOptions {
+    query?: string;
+    category?: string;
+    minSuccessRate?: number;
+    minCalls?: number;
+    limit?: number;
+    offset?: number;
+}
+interface ResourceCreateInput {
+    url: string;
+    name: string;
+    description?: string;
+    category?: string;
+    price: string;
+    icon_url?: string;
+}
+interface ResourceUpdateInput {
+    name?: string;
+    description?: string;
+    category?: string;
+    price?: string;
+    icon_url?: string;
+}
+interface WalletConfig {
+    [key: string]: unknown;
+}
+interface ConfigOptions {
+    apiKey?: string;
+    baseUrl?: string;
+    wallet?: WalletConfig;
+}
+type ErrorCode = 'NOT_FOUND' | 'PAYMENT_REQUIRED' | 'RATE_LIMITED' | 'UNAUTHORIZED' | 'FORBIDDEN' | 'VALIDATION_ERROR' | 'SERVER_ERROR';
+
+declare function checkUrl(url: string): Promise<Score>;
+declare function checkMany(urls: string[]): Promise<Score[]>;
+declare function checkExists(url: string): Promise<boolean>;
+declare function checkTop(options?: TopOptions): Promise<Score[]>;
+type CheckFunction = typeof checkUrl & {
+    many: typeof checkMany;
+    exists: typeof checkExists;
+    top: typeof checkTop;
+};
+declare const check: CheckFunction;
+
+type GetInput = string | {
+    id: string;
+};
+declare function list(): Promise<Resource[]>;
+declare function get(input: GetInput): Promise<Resource>;
+declare function search(options?: ResourceSearchOptions): Promise<Resource[]>;
+declare function register(input: ResourceCreateInput): Promise<Resource>;
+declare function update(id: string, input: ResourceUpdateInput): Promise<Resource>;
+declare function remove(id: string): Promise<void>;
+declare const resources: {
+    list: typeof list;
+    get: typeof get;
+    search: typeof search;
+    register: typeof register;
+    update: typeof update;
+    delete: typeof remove;
+};
+
+declare function configure(options: ConfigOptions): void;
+
+declare class X402Error extends Error {
+    readonly code: ErrorCode;
+    readonly status: number;
+    constructor(code: ErrorCode, message: string, status: number);
+    static notFound(message?: string): X402Error;
+    static paymentRequired(message?: string): X402Error;
+    static rateLimited(message?: string): X402Error;
+    static unauthorized(message?: string): X402Error;
+    static forbidden(message?: string): X402Error;
+    static validationError(message: string): X402Error;
+    static serverError(message?: string): X402Error;
+    static fromStatus(status: number, message?: string): X402Error;
+}
+
+export { type ConfigOptions, type ErrorCode, type Resource, type ResourceCreateInput, type ResourceSearchOptions, type ResourceUpdateInput, type Score, type TopOptions, type WalletConfig, X402Error, check, configure, resources };

package/dist/index.d.ts

@@ -0,0 +1,106 @@
+interface Score {
+    url: string;
+    success_rate: number | null;
+    calls: number;
+    value_processed: string;
+    last_called: string | null;
+}
+interface TopOptions {
+    limit?: number;
+    category?: string;
+}
+interface Resource {
+    id: string;
+    url: string;
+    name: string;
+    description: string;
+    icon_url: string | null;
+    category: string;
+    price: string;
+    owner_id: string;
+    created_at: string;
+    updated_at: string;
+    success_rate: number | null;
+    calls: number;
+    value_processed: string;
+    last_called: string | null;
+}
+interface ResourceSearchOptions {
+    query?: string;
+    category?: string;
+    minSuccessRate?: number;
+    minCalls?: number;
+    limit?: number;
+    offset?: number;
+}
+interface ResourceCreateInput {
+    url: string;
+    name: string;
+    description?: string;
+    category?: string;
+    price: string;
+    icon_url?: string;
+}
+interface ResourceUpdateInput {
+    name?: string;
+    description?: string;
+    category?: string;
+    price?: string;
+    icon_url?: string;
+}
+interface WalletConfig {
+    [key: string]: unknown;
+}
+interface ConfigOptions {
+    apiKey?: string;
+    baseUrl?: string;
+    wallet?: WalletConfig;
+}
+type ErrorCode = 'NOT_FOUND' | 'PAYMENT_REQUIRED' | 'RATE_LIMITED' | 'UNAUTHORIZED' | 'FORBIDDEN' | 'VALIDATION_ERROR' | 'SERVER_ERROR';
+
+declare function checkUrl(url: string): Promise<Score>;
+declare function checkMany(urls: string[]): Promise<Score[]>;
+declare function checkExists(url: string): Promise<boolean>;
+declare function checkTop(options?: TopOptions): Promise<Score[]>;
+type CheckFunction = typeof checkUrl & {
+    many: typeof checkMany;
+    exists: typeof checkExists;
+    top: typeof checkTop;
+};
+declare const check: CheckFunction;
+
+type GetInput = string | {
+    id: string;
+};
+declare function list(): Promise<Resource[]>;
+declare function get(input: GetInput): Promise<Resource>;
+declare function search(options?: ResourceSearchOptions): Promise<Resource[]>;
+declare function register(input: ResourceCreateInput): Promise<Resource>;
+declare function update(id: string, input: ResourceUpdateInput): Promise<Resource>;
+declare function remove(id: string): Promise<void>;
+declare const resources: {
+    list: typeof list;
+    get: typeof get;
+    search: typeof search;
+    register: typeof register;
+    update: typeof update;
+    delete: typeof remove;
+};
+
+declare function configure(options: ConfigOptions): void;
+
+declare class X402Error extends Error {
+    readonly code: ErrorCode;
+    readonly status: number;
+    constructor(code: ErrorCode, message: string, status: number);
+    static notFound(message?: string): X402Error;
+    static paymentRequired(message?: string): X402Error;
+    static rateLimited(message?: string): X402Error;
+    static unauthorized(message?: string): X402Error;
+    static forbidden(message?: string): X402Error;
+    static validationError(message: string): X402Error;
+    static serverError(message?: string): X402Error;
+    static fromStatus(status: number, message?: string): X402Error;
+}
+
+export { type ConfigOptions, type ErrorCode, type Resource, type ResourceCreateInput, type ResourceSearchOptions, type ResourceUpdateInput, type Score, type TopOptions, type WalletConfig, X402Error, check, configure, resources };

package/dist/index.js

@@ -0,0 +1,238 @@
+"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, {
+  X402Error: () => X402Error,
+  check: () => check,
+  configure: () => configure,
+  resources: () => resources
+});
+module.exports = __toCommonJS(index_exports);
+
+// src/config.ts
+var DEFAULT_BASE_URL = "https://x402.jobs/api/v1";
+var config = {
+  apiKey: null,
+  baseUrl: DEFAULT_BASE_URL,
+  wallet: null
+};
+function configure(options) {
+  if (options.apiKey !== void 0) {
+    config.apiKey = options.apiKey;
+  }
+  if (options.baseUrl !== void 0) {
+    config.baseUrl = options.baseUrl.replace(/\/$/, "");
+  }
+  if (options.wallet !== void 0) {
+    config.wallet = options.wallet;
+  }
+}
+function getConfig() {
+  return config;
+}
+
+// src/errors.ts
+var X402Error = class _X402Error extends Error {
+  constructor(code, message, status) {
+    super(message);
+    this.name = "X402Error";
+    this.code = code;
+    this.status = status;
+    if (Error.captureStackTrace) {
+      Error.captureStackTrace(this, _X402Error);
+    }
+  }
+  static notFound(message = "Resource not found") {
+    return new _X402Error("NOT_FOUND", message, 404);
+  }
+  static paymentRequired(message = "Payment required") {
+    return new _X402Error("PAYMENT_REQUIRED", message, 402);
+  }
+  static rateLimited(message = "Too many requests") {
+    return new _X402Error("RATE_LIMITED", message, 429);
+  }
+  static unauthorized(message = "Invalid or missing API key") {
+    return new _X402Error("UNAUTHORIZED", message, 401);
+  }
+  static forbidden(message = "Access denied") {
+    return new _X402Error("FORBIDDEN", message, 403);
+  }
+  static validationError(message) {
+    return new _X402Error("VALIDATION_ERROR", message, 400);
+  }
+  static serverError(message = "Internal server error") {
+    return new _X402Error("SERVER_ERROR", message, 500);
+  }
+  static fromStatus(status, message) {
+    switch (status) {
+      case 400:
+        return _X402Error.validationError(message ?? "Invalid request");
+      case 401:
+        return _X402Error.unauthorized(message);
+      case 402:
+        return _X402Error.paymentRequired(message);
+      case 403:
+        return _X402Error.forbidden(message);
+      case 404:
+        return _X402Error.notFound(message);
+      case 429:
+        return _X402Error.rateLimited(message);
+      default:
+        return _X402Error.serverError(message);
+    }
+  }
+};
+
+// src/http.ts
+function buildUrl(path, params) {
+  const { baseUrl } = getConfig();
+  const url = new URL(path, baseUrl);
+  if (params) {
+    for (const [key, value] of Object.entries(params)) {
+      if (value !== void 0) {
+        url.searchParams.set(key, String(value));
+      }
+    }
+  }
+  return url.toString();
+}
+function getHeaders() {
+  const { apiKey } = getConfig();
+  const headers = {
+    "Content-Type": "application/json",
+    Accept: "application/json"
+  };
+  if (apiKey) {
+    headers["Authorization"] = `Bearer ${apiKey}`;
+  }
+  return headers;
+}
+async function parseResponse(response) {
+  const contentType = response.headers.get("content-type");
+  if (!contentType?.includes("application/json")) {
+    if (!response.ok) {
+      throw X402Error.fromStatus(response.status, response.statusText);
+    }
+    return void 0;
+  }
+  const data = await response.json();
+  if (!response.ok) {
+    const errorData = data;
+    const message = errorData?.error?.message ?? response.statusText;
+    throw X402Error.fromStatus(response.status, message);
+  }
+  return data;
+}
+async function request(path, options = {}) {
+  const { method = "GET", body, params } = options;
+  const url = buildUrl(path, params);
+  const headers = getHeaders();
+  const fetchOptions = {
+    method,
+    headers
+  };
+  if (body !== void 0) {
+    fetchOptions.body = JSON.stringify(body);
+  }
+  const response = await fetch(url, fetchOptions);
+  return parseResponse(response);
+}
+var http = {
+  get(path, params) {
+    return request(path, { method: "GET", params });
+  },
+  post(path, body) {
+    return request(path, { method: "POST", body });
+  },
+  patch(path, body) {
+    return request(path, { method: "PATCH", body });
+  },
+  delete(path) {
+    return request(path, { method: "DELETE" });
+  }
+};
+
+// src/check.ts
+async function checkUrl(url) {
+  return http.get("/resources/score", { url });
+}
+async function checkMany(urls) {
+  return Promise.all(urls.map((url) => checkUrl(url)));
+}
+async function checkExists(url) {
+  const result = await http.get("/resources/exists", { url });
+  return result.exists;
+}
+async function checkTop(options = {}) {
+  const { limit = 20, category } = options;
+  return http.get("/resources/top", { limit, category });
+}
+var check = Object.assign(checkUrl, {
+  many: checkMany,
+  exists: checkExists,
+  top: checkTop
+});
+
+// src/resources.ts
+async function list() {
+  return http.get("/resources");
+}
+async function get(input) {
+  if (typeof input === "string") {
+    return http.get("/resources", { url: input });
+  }
+  return http.get(`/resources/${input.id}`);
+}
+async function search(options = {}) {
+  const params = {};
+  if (options.query) params["q"] = options.query;
+  if (options.category) params["category"] = options.category;
+  if (options.minSuccessRate !== void 0) params["min_success_rate"] = options.minSuccessRate;
+  if (options.minCalls !== void 0) params["min_calls"] = options.minCalls;
+  if (options.limit !== void 0) params["limit"] = options.limit;
+  if (options.offset !== void 0) params["offset"] = options.offset;
+  return http.get("/resources/search", params);
+}
+async function register(input) {
+  return http.post("/resources", input);
+}
+async function update(id, input) {
+  return http.patch(`/resources/${id}`, input);
+}
+async function remove(id) {
+  await http.delete(`/resources/${id}`);
+}
+var resources = {
+  list,
+  get,
+  search,
+  register,
+  update,
+  delete: remove
+};
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  X402Error,
+  check,
+  configure,
+  resources
+});
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/index.ts","../src/config.ts","../src/errors.ts","../src/http.ts","../src/check.ts","../src/resources.ts"],"sourcesContent":["// Main exports\nexport { check } from './check'\nexport { resources } from './resources'\nexport { configure } from './config'\nexport { X402Error } from './errors'\n\n// Type exports\nexport type {\n  Score,\n  TopOptions,\n  Resource,\n  ResourceSearchOptions,\n  ResourceCreateInput,\n  ResourceUpdateInput,\n  ConfigOptions,\n  WalletConfig,\n  ErrorCode,\n} from './types'\n","import type { ConfigOptions, WalletConfig } from './types'\n\nconst DEFAULT_BASE_URL = 'https://x402.jobs/api/v1'\n\ninterface InternalConfig {\n  apiKey: string | null\n  baseUrl: string\n  wallet: WalletConfig | null\n}\n\nconst config: InternalConfig = {\n  apiKey: null,\n  baseUrl: DEFAULT_BASE_URL,\n  wallet: null,\n}\n\nexport function configure(options: ConfigOptions): void {\n  if (options.apiKey !== undefined) {\n    config.apiKey = options.apiKey\n  }\n  if (options.baseUrl !== undefined) {\n    config.baseUrl = options.baseUrl.replace(/\\/$/, '') // Remove trailing slash\n  }\n  if (options.wallet !== undefined) {\n    config.wallet = options.wallet\n  }\n}\n\nexport function getConfig(): Readonly<InternalConfig> {\n  return config\n}\n\nexport function resetConfig(): void {\n  config.apiKey = null\n  config.baseUrl = DEFAULT_BASE_URL\n  config.wallet = null\n}\n","import type { ErrorCode } from './types'\n\nexport class X402Error extends Error {\n  readonly code: ErrorCode\n  readonly status: number\n\n  constructor(code: ErrorCode, message: string, status: number) {\n    super(message)\n    this.name = 'X402Error'\n    this.code = code\n    this.status = status\n\n    // Maintains proper stack trace for where error was thrown (V8 engines)\n    if (Error.captureStackTrace) {\n      Error.captureStackTrace(this, X402Error)\n    }\n  }\n\n  static notFound(message = 'Resource not found'): X402Error {\n    return new X402Error('NOT_FOUND', message, 404)\n  }\n\n  static paymentRequired(message = 'Payment required'): X402Error {\n    return new X402Error('PAYMENT_REQUIRED', message, 402)\n  }\n\n  static rateLimited(message = 'Too many requests'): X402Error {\n    return new X402Error('RATE_LIMITED', message, 429)\n  }\n\n  static unauthorized(message = 'Invalid or missing API key'): X402Error {\n    return new X402Error('UNAUTHORIZED', message, 401)\n  }\n\n  static forbidden(message = 'Access denied'): X402Error {\n    return new X402Error('FORBIDDEN', message, 403)\n  }\n\n  static validationError(message: string): X402Error {\n    return new X402Error('VALIDATION_ERROR', message, 400)\n  }\n\n  static serverError(message = 'Internal server error'): X402Error {\n    return new X402Error('SERVER_ERROR', message, 500)\n  }\n\n  static fromStatus(status: number, message?: string): X402Error {\n    switch (status) {\n      case 400:\n        return X402Error.validationError(message ?? 'Invalid request')\n      case 401:\n        return X402Error.unauthorized(message)\n      case 402:\n        return X402Error.paymentRequired(message)\n      case 403:\n        return X402Error.forbidden(message)\n      case 404:\n        return X402Error.notFound(message)\n      case 429:\n        return X402Error.rateLimited(message)\n      default:\n        return X402Error.serverError(message)\n    }\n  }\n}\n","import { getConfig } from './config'\nimport { X402Error } from './errors'\n\ntype HttpMethod = 'GET' | 'POST' | 'PATCH' | 'DELETE'\n\ninterface RequestOptions {\n  method?: HttpMethod\n  body?: unknown\n  params?: Record<string, string | number | boolean | undefined>\n}\n\nfunction buildUrl(path: string, params?: RequestOptions['params']): string {\n  const { baseUrl } = getConfig()\n  const url = new URL(path, baseUrl)\n\n  if (params) {\n    for (const [key, value] of Object.entries(params)) {\n      if (value !== undefined) {\n        url.searchParams.set(key, String(value))\n      }\n    }\n  }\n\n  return url.toString()\n}\n\nfunction getHeaders(): Record<string, string> {\n  const { apiKey } = getConfig()\n  const headers: Record<string, string> = {\n    'Content-Type': 'application/json',\n    Accept: 'application/json',\n  }\n\n  if (apiKey) {\n    headers['Authorization'] = `Bearer ${apiKey}`\n  }\n\n  return headers\n}\n\nasync function parseResponse<T>(response: Response): Promise<T> {\n  const contentType = response.headers.get('content-type')\n\n  if (!contentType?.includes('application/json')) {\n    if (!response.ok) {\n      throw X402Error.fromStatus(response.status, response.statusText)\n    }\n    return undefined as T\n  }\n\n  const data = (await response.json()) as { error?: { code?: string; message?: string } } | T\n\n  if (!response.ok) {\n    const errorData = data as { error?: { code?: string; message?: string } }\n    const message = errorData?.error?.message ?? response.statusText\n    throw X402Error.fromStatus(response.status, message)\n  }\n\n  return data as T\n}\n\nexport async function request<T>(\n  path: string,\n  options: RequestOptions = {}\n): Promise<T> {\n  const { method = 'GET', body, params } = options\n  const url = buildUrl(path, params)\n  const headers = getHeaders()\n\n  const fetchOptions: RequestInit = {\n    method,\n    headers,\n  }\n\n  if (body !== undefined) {\n    fetchOptions.body = JSON.stringify(body)\n  }\n\n  const response = await fetch(url, fetchOptions)\n  return parseResponse<T>(response)\n}\n\nexport const http = {\n  get<T>(path: string, params?: RequestOptions['params']): Promise<T> {\n    return request<T>(path, { method: 'GET', params })\n  },\n\n  post<T>(path: string, body?: unknown): Promise<T> {\n    return request<T>(path, { method: 'POST', body })\n  },\n\n  patch<T>(path: string, body?: unknown): Promise<T> {\n    return request<T>(path, { method: 'PATCH', body })\n  },\n\n  delete<T>(path: string): Promise<T> {\n    return request<T>(path, { method: 'DELETE' })\n  },\n}\n","import { http } from './http'\nimport type { Score, TopOptions } from './types'\n\nasync function checkUrl(url: string): Promise<Score> {\n  return http.get<Score>('/resources/score', { url })\n}\n\nasync function checkMany(urls: string[]): Promise<Score[]> {\n  // Phase 2: Use batch endpoint when available\n  // For now, run checks in parallel\n  return Promise.all(urls.map((url) => checkUrl(url)))\n}\n\nasync function checkExists(url: string): Promise<boolean> {\n  const result = await http.get<{ exists: boolean }>('/resources/exists', { url })\n  return result.exists\n}\n\nasync function checkTop(options: TopOptions = {}): Promise<Score[]> {\n  const { limit = 20, category } = options\n  return http.get<Score[]>('/resources/top', { limit, category })\n}\n\n// Create the check function with additional methods attached\ntype CheckFunction = typeof checkUrl & {\n  many: typeof checkMany\n  exists: typeof checkExists\n  top: typeof checkTop\n}\n\nexport const check: CheckFunction = Object.assign(checkUrl, {\n  many: checkMany,\n  exists: checkExists,\n  top: checkTop,\n})\n","import { http } from './http'\nimport type {\n  Resource,\n  ResourceSearchOptions,\n  ResourceCreateInput,\n  ResourceUpdateInput,\n} from './types'\n\ntype GetInput = string | { id: string }\n\nasync function list(): Promise<Resource[]> {\n  return http.get<Resource[]>('/resources')\n}\n\nasync function get(input: GetInput): Promise<Resource> {\n  if (typeof input === 'string') {\n    // Treat string as URL\n    return http.get<Resource>('/resources', { url: input })\n  }\n  // Get by ID\n  return http.get<Resource>(`/resources/${input.id}`)\n}\n\nasync function search(options: ResourceSearchOptions = {}): Promise<Resource[]> {\n  const params: Record<string, string | number | undefined> = {}\n\n  if (options.query) params['q'] = options.query\n  if (options.category) params['category'] = options.category\n  if (options.minSuccessRate !== undefined) params['min_success_rate'] = options.minSuccessRate\n  if (options.minCalls !== undefined) params['min_calls'] = options.minCalls\n  if (options.limit !== undefined) params['limit'] = options.limit\n  if (options.offset !== undefined) params['offset'] = options.offset\n\n  return http.get<Resource[]>('/resources/search', params)\n}\n\nasync function register(input: ResourceCreateInput): Promise<Resource> {\n  return http.post<Resource>('/resources', input)\n}\n\nasync function update(id: string, input: ResourceUpdateInput): Promise<Resource> {\n  return http.patch<Resource>(`/resources/${id}`, input)\n}\n\nasync function remove(id: string): Promise<void> {\n  await http.delete(`/resources/${id}`)\n}\n\nexport const resources = {\n  list,\n  get,\n  search,\n  register,\n  update,\n  delete: remove,\n}\n"],"mappings":"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","names":[]}

package/dist/index.mjs

@@ -0,0 +1,208 @@
+// src/config.ts
+var DEFAULT_BASE_URL = "https://x402.jobs/api/v1";
+var config = {
+  apiKey: null,
+  baseUrl: DEFAULT_BASE_URL,
+  wallet: null
+};
+function configure(options) {
+  if (options.apiKey !== void 0) {
+    config.apiKey = options.apiKey;
+  }
+  if (options.baseUrl !== void 0) {
+    config.baseUrl = options.baseUrl.replace(/\/$/, "");
+  }
+  if (options.wallet !== void 0) {
+    config.wallet = options.wallet;
+  }
+}
+function getConfig() {
+  return config;
+}
+
+// src/errors.ts
+var X402Error = class _X402Error extends Error {
+  constructor(code, message, status) {
+    super(message);
+    this.name = "X402Error";
+    this.code = code;
+    this.status = status;
+    if (Error.captureStackTrace) {
+      Error.captureStackTrace(this, _X402Error);
+    }
+  }
+  static notFound(message = "Resource not found") {
+    return new _X402Error("NOT_FOUND", message, 404);
+  }
+  static paymentRequired(message = "Payment required") {
+    return new _X402Error("PAYMENT_REQUIRED", message, 402);
+  }
+  static rateLimited(message = "Too many requests") {
+    return new _X402Error("RATE_LIMITED", message, 429);
+  }
+  static unauthorized(message = "Invalid or missing API key") {
+    return new _X402Error("UNAUTHORIZED", message, 401);
+  }
+  static forbidden(message = "Access denied") {
+    return new _X402Error("FORBIDDEN", message, 403);
+  }
+  static validationError(message) {
+    return new _X402Error("VALIDATION_ERROR", message, 400);
+  }
+  static serverError(message = "Internal server error") {
+    return new _X402Error("SERVER_ERROR", message, 500);
+  }
+  static fromStatus(status, message) {
+    switch (status) {
+      case 400:
+        return _X402Error.validationError(message ?? "Invalid request");
+      case 401:
+        return _X402Error.unauthorized(message);
+      case 402:
+        return _X402Error.paymentRequired(message);
+      case 403:
+        return _X402Error.forbidden(message);
+      case 404:
+        return _X402Error.notFound(message);
+      case 429:
+        return _X402Error.rateLimited(message);
+      default:
+        return _X402Error.serverError(message);
+    }
+  }
+};
+
+// src/http.ts
+function buildUrl(path, params) {
+  const { baseUrl } = getConfig();
+  const url = new URL(path, baseUrl);
+  if (params) {
+    for (const [key, value] of Object.entries(params)) {
+      if (value !== void 0) {
+        url.searchParams.set(key, String(value));
+      }
+    }
+  }
+  return url.toString();
+}
+function getHeaders() {
+  const { apiKey } = getConfig();
+  const headers = {
+    "Content-Type": "application/json",
+    Accept: "application/json"
+  };
+  if (apiKey) {
+    headers["Authorization"] = `Bearer ${apiKey}`;
+  }
+  return headers;
+}
+async function parseResponse(response) {
+  const contentType = response.headers.get("content-type");
+  if (!contentType?.includes("application/json")) {
+    if (!response.ok) {
+      throw X402Error.fromStatus(response.status, response.statusText);
+    }
+    return void 0;
+  }
+  const data = await response.json();
+  if (!response.ok) {
+    const errorData = data;
+    const message = errorData?.error?.message ?? response.statusText;
+    throw X402Error.fromStatus(response.status, message);
+  }
+  return data;
+}
+async function request(path, options = {}) {
+  const { method = "GET", body, params } = options;
+  const url = buildUrl(path, params);
+  const headers = getHeaders();
+  const fetchOptions = {
+    method,
+    headers
+  };
+  if (body !== void 0) {
+    fetchOptions.body = JSON.stringify(body);
+  }
+  const response = await fetch(url, fetchOptions);
+  return parseResponse(response);
+}
+var http = {
+  get(path, params) {
+    return request(path, { method: "GET", params });
+  },
+  post(path, body) {
+    return request(path, { method: "POST", body });
+  },
+  patch(path, body) {
+    return request(path, { method: "PATCH", body });
+  },
+  delete(path) {
+    return request(path, { method: "DELETE" });
+  }
+};
+
+// src/check.ts
+async function checkUrl(url) {
+  return http.get("/resources/score", { url });
+}
+async function checkMany(urls) {
+  return Promise.all(urls.map((url) => checkUrl(url)));
+}
+async function checkExists(url) {
+  const result = await http.get("/resources/exists", { url });
+  return result.exists;
+}
+async function checkTop(options = {}) {
+  const { limit = 20, category } = options;
+  return http.get("/resources/top", { limit, category });
+}
+var check = Object.assign(checkUrl, {
+  many: checkMany,
+  exists: checkExists,
+  top: checkTop
+});
+
+// src/resources.ts
+async function list() {
+  return http.get("/resources");
+}
+async function get(input) {
+  if (typeof input === "string") {
+    return http.get("/resources", { url: input });
+  }
+  return http.get(`/resources/${input.id}`);
+}
+async function search(options = {}) {
+  const params = {};
+  if (options.query) params["q"] = options.query;
+  if (options.category) params["category"] = options.category;
+  if (options.minSuccessRate !== void 0) params["min_success_rate"] = options.minSuccessRate;
+  if (options.minCalls !== void 0) params["min_calls"] = options.minCalls;
+  if (options.limit !== void 0) params["limit"] = options.limit;
+  if (options.offset !== void 0) params["offset"] = options.offset;
+  return http.get("/resources/search", params);
+}
+async function register(input) {
+  return http.post("/resources", input);
+}
+async function update(id, input) {
+  return http.patch(`/resources/${id}`, input);
+}
+async function remove(id) {
+  await http.delete(`/resources/${id}`);
+}
+var resources = {
+  list,
+  get,
+  search,
+  register,
+  update,
+  delete: remove
+};
+export {
+  X402Error,
+  check,
+  configure,
+  resources
+};
+//# sourceMappingURL=index.mjs.map

package/dist/index.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/config.ts","../src/errors.ts","../src/http.ts","../src/check.ts","../src/resources.ts"],"sourcesContent":["import type { ConfigOptions, WalletConfig } from './types'\n\nconst DEFAULT_BASE_URL = 'https://x402.jobs/api/v1'\n\ninterface InternalConfig {\n  apiKey: string | null\n  baseUrl: string\n  wallet: WalletConfig | null\n}\n\nconst config: InternalConfig = {\n  apiKey: null,\n  baseUrl: DEFAULT_BASE_URL,\n  wallet: null,\n}\n\nexport function configure(options: ConfigOptions): void {\n  if (options.apiKey !== undefined) {\n    config.apiKey = options.apiKey\n  }\n  if (options.baseUrl !== undefined) {\n    config.baseUrl = options.baseUrl.replace(/\\/$/, '') // Remove trailing slash\n  }\n  if (options.wallet !== undefined) {\n    config.wallet = options.wallet\n  }\n}\n\nexport function getConfig(): Readonly<InternalConfig> {\n  return config\n}\n\nexport function resetConfig(): void {\n  config.apiKey = null\n  config.baseUrl = DEFAULT_BASE_URL\n  config.wallet = null\n}\n","import type { ErrorCode } from './types'\n\nexport class X402Error extends Error {\n  readonly code: ErrorCode\n  readonly status: number\n\n  constructor(code: ErrorCode, message: string, status: number) {\n    super(message)\n    this.name = 'X402Error'\n    this.code = code\n    this.status = status\n\n    // Maintains proper stack trace for where error was thrown (V8 engines)\n    if (Error.captureStackTrace) {\n      Error.captureStackTrace(this, X402Error)\n    }\n  }\n\n  static notFound(message = 'Resource not found'): X402Error {\n    return new X402Error('NOT_FOUND', message, 404)\n  }\n\n  static paymentRequired(message = 'Payment required'): X402Error {\n    return new X402Error('PAYMENT_REQUIRED', message, 402)\n  }\n\n  static rateLimited(message = 'Too many requests'): X402Error {\n    return new X402Error('RATE_LIMITED', message, 429)\n  }\n\n  static unauthorized(message = 'Invalid or missing API key'): X402Error {\n    return new X402Error('UNAUTHORIZED', message, 401)\n  }\n\n  static forbidden(message = 'Access denied'): X402Error {\n    return new X402Error('FORBIDDEN', message, 403)\n  }\n\n  static validationError(message: string): X402Error {\n    return new X402Error('VALIDATION_ERROR', message, 400)\n  }\n\n  static serverError(message = 'Internal server error'): X402Error {\n    return new X402Error('SERVER_ERROR', message, 500)\n  }\n\n  static fromStatus(status: number, message?: string): X402Error {\n    switch (status) {\n      case 400:\n        return X402Error.validationError(message ?? 'Invalid request')\n      case 401:\n        return X402Error.unauthorized(message)\n      case 402:\n        return X402Error.paymentRequired(message)\n      case 403:\n        return X402Error.forbidden(message)\n      case 404:\n        return X402Error.notFound(message)\n      case 429:\n        return X402Error.rateLimited(message)\n      default:\n        return X402Error.serverError(message)\n    }\n  }\n}\n","import { getConfig } from './config'\nimport { X402Error } from './errors'\n\ntype HttpMethod = 'GET' | 'POST' | 'PATCH' | 'DELETE'\n\ninterface RequestOptions {\n  method?: HttpMethod\n  body?: unknown\n  params?: Record<string, string | number | boolean | undefined>\n}\n\nfunction buildUrl(path: string, params?: RequestOptions['params']): string {\n  const { baseUrl } = getConfig()\n  const url = new URL(path, baseUrl)\n\n  if (params) {\n    for (const [key, value] of Object.entries(params)) {\n      if (value !== undefined) {\n        url.searchParams.set(key, String(value))\n      }\n    }\n  }\n\n  return url.toString()\n}\n\nfunction getHeaders(): Record<string, string> {\n  const { apiKey } = getConfig()\n  const headers: Record<string, string> = {\n    'Content-Type': 'application/json',\n    Accept: 'application/json',\n  }\n\n  if (apiKey) {\n    headers['Authorization'] = `Bearer ${apiKey}`\n  }\n\n  return headers\n}\n\nasync function parseResponse<T>(response: Response): Promise<T> {\n  const contentType = response.headers.get('content-type')\n\n  if (!contentType?.includes('application/json')) {\n    if (!response.ok) {\n      throw X402Error.fromStatus(response.status, response.statusText)\n    }\n    return undefined as T\n  }\n\n  const data = (await response.json()) as { error?: { code?: string; message?: string } } | T\n\n  if (!response.ok) {\n    const errorData = data as { error?: { code?: string; message?: string } }\n    const message = errorData?.error?.message ?? response.statusText\n    throw X402Error.fromStatus(response.status, message)\n  }\n\n  return data as T\n}\n\nexport async function request<T>(\n  path: string,\n  options: RequestOptions = {}\n): Promise<T> {\n  const { method = 'GET', body, params } = options\n  const url = buildUrl(path, params)\n  const headers = getHeaders()\n\n  const fetchOptions: RequestInit = {\n    method,\n    headers,\n  }\n\n  if (body !== undefined) {\n    fetchOptions.body = JSON.stringify(body)\n  }\n\n  const response = await fetch(url, fetchOptions)\n  return parseResponse<T>(response)\n}\n\nexport const http = {\n  get<T>(path: string, params?: RequestOptions['params']): Promise<T> {\n    return request<T>(path, { method: 'GET', params })\n  },\n\n  post<T>(path: string, body?: unknown): Promise<T> {\n    return request<T>(path, { method: 'POST', body })\n  },\n\n  patch<T>(path: string, body?: unknown): Promise<T> {\n    return request<T>(path, { method: 'PATCH', body })\n  },\n\n  delete<T>(path: string): Promise<T> {\n    return request<T>(path, { method: 'DELETE' })\n  },\n}\n","import { http } from './http'\nimport type { Score, TopOptions } from './types'\n\nasync function checkUrl(url: string): Promise<Score> {\n  return http.get<Score>('/resources/score', { url })\n}\n\nasync function checkMany(urls: string[]): Promise<Score[]> {\n  // Phase 2: Use batch endpoint when available\n  // For now, run checks in parallel\n  return Promise.all(urls.map((url) => checkUrl(url)))\n}\n\nasync function checkExists(url: string): Promise<boolean> {\n  const result = await http.get<{ exists: boolean }>('/resources/exists', { url })\n  return result.exists\n}\n\nasync function checkTop(options: TopOptions = {}): Promise<Score[]> {\n  const { limit = 20, category } = options\n  return http.get<Score[]>('/resources/top', { limit, category })\n}\n\n// Create the check function with additional methods attached\ntype CheckFunction = typeof checkUrl & {\n  many: typeof checkMany\n  exists: typeof checkExists\n  top: typeof checkTop\n}\n\nexport const check: CheckFunction = Object.assign(checkUrl, {\n  many: checkMany,\n  exists: checkExists,\n  top: checkTop,\n})\n","import { http } from './http'\nimport type {\n  Resource,\n  ResourceSearchOptions,\n  ResourceCreateInput,\n  ResourceUpdateInput,\n} from './types'\n\ntype GetInput = string | { id: string }\n\nasync function list(): Promise<Resource[]> {\n  return http.get<Resource[]>('/resources')\n}\n\nasync function get(input: GetInput): Promise<Resource> {\n  if (typeof input === 'string') {\n    // Treat string as URL\n    return http.get<Resource>('/resources', { url: input })\n  }\n  // Get by ID\n  return http.get<Resource>(`/resources/${input.id}`)\n}\n\nasync function search(options: ResourceSearchOptions = {}): Promise<Resource[]> {\n  const params: Record<string, string | number | undefined> = {}\n\n  if (options.query) params['q'] = options.query\n  if (options.category) params['category'] = options.category\n  if (options.minSuccessRate !== undefined) params['min_success_rate'] = options.minSuccessRate\n  if (options.minCalls !== undefined) params['min_calls'] = options.minCalls\n  if (options.limit !== undefined) params['limit'] = options.limit\n  if (options.offset !== undefined) params['offset'] = options.offset\n\n  return http.get<Resource[]>('/resources/search', params)\n}\n\nasync function register(input: ResourceCreateInput): Promise<Resource> {\n  return http.post<Resource>('/resources', input)\n}\n\nasync function update(id: string, input: ResourceUpdateInput): Promise<Resource> {\n  return http.patch<Resource>(`/resources/${id}`, input)\n}\n\nasync function remove(id: string): Promise<void> {\n  await http.delete(`/resources/${id}`)\n}\n\nexport const resources = {\n  list,\n  get,\n  search,\n  register,\n  update,\n  delete: remove,\n}\n"],"mappings":"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","names":[]}

package/package.json

@@ -0,0 +1,52 @@
+{
+  "name": "@x402jobs/sdk",
+  "version": "0.1.0",
+  "description": "The official SDK for x402.jobs — trust, discovery, and resource management for x402",
+  "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"
+  ],
+  "scripts": {
+    "build": "tsup",
+    "dev": "tsup --watch",
+    "test": "vitest",
+    "test:run": "vitest run",
+    "typecheck": "tsc --noEmit",
+    "lint": "eslint src",
+    "prepublishOnly": "npm run build"
+  },
+  "keywords": [
+    "x402",
+    "trust",
+    "reliability",
+    "api",
+    "resources",
+    "micropayments",
+    "verification"
+  ],
+  "author": "x402jobs",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/x402jobs/sdk"
+  },
+  "homepage": "https://x402.jobs",
+  "devDependencies": {
+    "@types/node": "^20.0.0",
+    "tsup": "^8.0.0",
+    "typescript": "^5.0.0",
+    "vitest": "^1.0.0"
+  },
+  "engines": {
+    "node": ">=18"
+  }
+}