@ethitrust/sdk 1.0.0

package/dist/types.d.ts

@@ -0,0 +1,229 @@
+/**
+ * Typed models for the Ethitrust org-escrows API.
+ * Generated by hand from the OpenAPI spec (ethi-mono v0.1.0).
+ */
+export type EscrowType = 'onetime' | 'milestone' | 'recurring';
+export type EscrowStatus = 'invited' | 'counter_pending_initiator' | 'counter_pending_counterparty' | 'rejected' | 'expired' | 'pending' | 'active' | 'submitted' | 'in_review' | 'completed' | 'disputed' | 'cancelled' | 'refunded';
+export type InitiatorActorType = 'user' | 'organization';
+export type InitiatorRole = 'buyer' | 'seller';
+export type FeePayer = 'buyer' | 'seller' | 'split';
+export type CounterStatus = 'none' | 'awaiting_initiator' | 'awaiting_counterparty' | 'accepted' | 'rejected';
+export type RiskSeverity = 'low' | 'medium' | 'high';
+export type MilestoneStatus = 'pending' | 'in_progress' | 'delivered' | 'completed' | 'disputed';
+export interface RiskFlag {
+    code: string;
+    message: string;
+    severity: RiskSeverity;
+}
+export interface LatestEvent {
+    event_type: string;
+    actor: string;
+    timestamp: string;
+    metadata?: Record<string, unknown> | null;
+}
+export interface EscrowVolumePoint {
+    date: string;
+    count: number;
+    total_amount: number;
+}
+export interface MilestoneRequest {
+    title: string;
+    description?: string | null;
+    amount: number;
+    due_date?: string | null;
+    /** Defaults to 48 on the server. */
+    inspection_hrs?: number;
+}
+export interface MilestoneResponse {
+    id: string;
+    escrow_id: string;
+    title: string;
+    description: string | null;
+    amount: number;
+    due_date: string | null;
+    inspection_hrs: number;
+    status: MilestoneStatus;
+    delivered_at: string | null;
+    completed_at: string | null;
+    sort_order: number;
+}
+export interface OrganizationInitializeEscrowRequest {
+    invitee_email: string;
+    /** Defaults to 'onetime'. */
+    escrow_type?: EscrowType;
+    title: string;
+    description?: string | null;
+    /** Defaults to 'ETB'. */
+    currency?: string;
+    amount: number;
+    acceptance_criteria?: string | null;
+    /** Hours. Defaults to 48. */
+    inspection_period?: number;
+    delivery_date?: string | null;
+    /** Hours. Defaults to 72. */
+    dispute_window?: number;
+    /** Defaults to 'buyer'. */
+    who_pays_fees?: FeePayer;
+    milestones?: MilestoneRequest[] | null;
+}
+export interface ListOrgEscrowsParams {
+    status?: string;
+    is_active?: boolean;
+    /** ISO 8601 date-time. */
+    date_from?: string | Date;
+    /** ISO 8601 date-time. */
+    date_to?: string | Date;
+    search?: string;
+    page?: number;
+    page_size?: number;
+}
+export interface OrgEscrowReportParams {
+    /** ISO 8601 date-time. */
+    date_from?: string | Date;
+    /** ISO 8601 date-time. */
+    date_to?: string | Date;
+}
+export interface InitializeEscrowResponse {
+    id: string;
+    escrow_type: EscrowType;
+    status: EscrowStatus;
+    initiator_actor_type: InitiatorActorType;
+    initiator_id: string | null;
+    initiator_org_id: string | null;
+    receiver_id: string | null;
+    receiver_email: string | null;
+    initiator_role: InitiatorRole;
+    title: string;
+    description: string | null;
+    currency: string;
+    amount: number;
+    fee_amount: number;
+    acceptance_criteria: string | null;
+    inspection_period: number;
+    delivery_date: string | null;
+    dispute_window: number;
+    who_pays_fees: FeePayer;
+    org_id: string | null;
+    offer_version: number;
+    counter_status: CounterStatus;
+    active_counter_offer_version: number | null;
+    created_at: string;
+    updated_at: string;
+    invitation_sent?: boolean;
+}
+export interface OrgEscrowCancelResponse extends InitializeEscrowResponse {
+    refunded?: boolean;
+}
+export interface OrgEscrowListItem {
+    escrow_id: string;
+    organization_id: string | null;
+    title: string;
+    status: string;
+    is_active: boolean;
+    amount: number;
+    currency: string;
+    receiver_email?: string | null;
+    funded_amount: number;
+    created_at: string;
+    updated_at: string;
+    expires_at?: string | null;
+}
+export interface OrgEscrowListResponse {
+    items: OrgEscrowListItem[];
+    page: number;
+    page_size: number;
+    total: number;
+    total_pages: number;
+}
+export interface OrgEscrowStatusResponse {
+    escrow_id: string;
+    organization_id: string | null;
+    status: string;
+    is_active: boolean;
+    can_cancel: boolean;
+    can_resend_invite: boolean;
+    can_accept: boolean;
+    expires_at: string | null;
+    funded_amount: number;
+    currency: string;
+    amount: number;
+    updated_at: string;
+}
+export interface OrgEscrowDetailResponse extends OrgEscrowStatusResponse {
+    title: string;
+    description?: string | null;
+    escrow_type: string;
+    initiator_role: string;
+    receiver_email?: string | null;
+    receiver_id?: string | null;
+    fee_amount: number;
+    who_pays_fees: string;
+    created_at: string;
+    /** 0-100. */
+    progress_percentage: number;
+    current_phase: string;
+    next_action?: string | null;
+    risk_flags?: RiskFlag[];
+    latest_event?: LatestEvent | null;
+}
+export interface OrgEscrowHealthResponse {
+    escrow_id: string;
+    is_active: boolean;
+    is_expired: boolean;
+    is_fundable: boolean;
+    is_cancellable: boolean;
+    is_disputable: boolean;
+    is_settled: boolean;
+}
+export interface OrgEscrowReportResponse {
+    organization_id: string;
+    period_from: string;
+    period_to: string;
+    total_escrows: number;
+    active_escrow_count: number;
+    completion_rate: number;
+    dispute_rate: number;
+    avg_settlement_time_hours?: number | null;
+    volume_over_time?: EscrowVolumePoint[];
+}
+export interface OrgEscrowAuditEvent {
+    event_id: string;
+    escrow_id: string;
+    actor: string;
+    action: string;
+    timestamp: string;
+    metadata?: Record<string, unknown> | null;
+}
+export interface OrgEscrowAuditTrailResponse {
+    escrow_id: string;
+    events: OrgEscrowAuditEvent[];
+    total: number;
+}
+export interface WebhookLogEntry {
+    id: string;
+    event_type: string;
+    target_url: string;
+    http_status: number | null;
+    attempt: number;
+    delivery_status: string;
+    error_message?: string | null;
+    created_at: string;
+    next_retry_at?: string | null;
+}
+export interface WebhookTestResponse {
+    success: boolean;
+    http_status?: number | null;
+    error?: string | null;
+    target_url?: string | null;
+}
+export interface ValidationErrorItem {
+    loc: Array<string | number>;
+    msg: string;
+    type: string;
+    input?: unknown;
+    ctx?: Record<string, unknown>;
+}
+export interface HTTPValidationError {
+    detail?: ValidationErrorItem[];
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

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

package/dist/types.js

@@ -0,0 +1,6 @@
+/**
+ * Typed models for the Ethitrust org-escrows API.
+ * Generated by hand from the OpenAPI spec (ethi-mono v0.1.0).
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA;;;GAGG"}

package/dist/utils/idempotency.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Generate a RFC-4122 v4 idempotency key suitable for the
+ * `X-Idempotency-Key` header.
+ *
+ * Falls back to the Web Crypto API when `node:crypto` is unavailable
+ * (e.g. edge runtimes).
+ */
+export declare function generateIdempotencyKey(prefix?: string): string;
+//# sourceMappingURL=idempotency.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"idempotency.d.ts","sourceRoot":"","sources":["../../src/utils/idempotency.ts"],"names":[],"mappings":"AAEA;;;;;;GAMG;AACH,wBAAgB,sBAAsB,CAAC,MAAM,CAAC,EAAE,MAAM,GAAG,MAAM,CAa9D"}

package/dist/utils/idempotency.js

@@ -0,0 +1,25 @@
+import { randomUUID, randomBytes } from 'node:crypto';
+/**
+ * Generate a RFC-4122 v4 idempotency key suitable for the
+ * `X-Idempotency-Key` header.
+ *
+ * Falls back to the Web Crypto API when `node:crypto` is unavailable
+ * (e.g. edge runtimes).
+ */
+export function generateIdempotencyKey(prefix) {
+    let id;
+    try {
+        id = randomUUID();
+    }
+    catch {
+        const g = globalThis;
+        if (g.crypto?.randomUUID) {
+            id = g.crypto.randomUUID();
+        }
+        else {
+            id = randomBytes(16).toString('hex');
+        }
+    }
+    return prefix ? `${prefix}_${id}` : id;
+}
+//# sourceMappingURL=idempotency.js.map

package/dist/utils/idempotency.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"idempotency.js","sourceRoot":"","sources":["../../src/utils/idempotency.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAEtD;;;;;;GAMG;AACH,MAAM,UAAU,sBAAsB,CAAC,MAAe;IACpD,IAAI,EAAU,CAAC;IACf,IAAI,CAAC;QACH,EAAE,GAAG,UAAU,EAAE,CAAC;IACpB,CAAC;IAAC,MAAM,CAAC;QACP,MAAM,CAAC,GAAG,UAAwD,CAAC;QACnE,IAAI,CAAC,CAAC,MAAM,EAAE,UAAU,EAAE,CAAC;YACzB,EAAE,GAAG,CAAC,CAAC,MAAM,CAAC,UAAU,EAAE,CAAC;QAC7B,CAAC;aAAM,CAAC;YACN,EAAE,GAAG,WAAW,CAAC,EAAE,CAAC,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC;QACvC,CAAC;IACH,CAAC;IACD,OAAO,MAAM,CAAC,CAAC,CAAC,GAAG,MAAM,IAAI,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;AACzC,CAAC"}

package/dist/utils/query.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Serialise a flat record to a URLSearchParams instance.
+ *  - `undefined` / `null` values are skipped.
+ *  - `Date` objects are serialised to ISO 8601.
+ *  - Arrays are repeated as `?key=a&key=b`.
+ */
+export declare function toQueryString(params: Record<string, unknown> | undefined): string;
+//# sourceMappingURL=query.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"query.d.ts","sourceRoot":"","sources":["../../src/utils/query.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,wBAAgB,aAAa,CAC3B,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,GAC1C,MAAM,CAgBR"}

package/dist/utils/query.js

@@ -0,0 +1,35 @@
+/**
+ * Serialise a flat record to a URLSearchParams instance.
+ *  - `undefined` / `null` values are skipped.
+ *  - `Date` objects are serialised to ISO 8601.
+ *  - Arrays are repeated as `?key=a&key=b`.
+ */
+export function toQueryString(params) {
+    if (!params)
+        return '';
+    const usp = new URLSearchParams();
+    for (const [k, v] of Object.entries(params)) {
+        if (v === undefined || v === null)
+            continue;
+        if (Array.isArray(v)) {
+            for (const item of v) {
+                if (item === undefined || item === null)
+                    continue;
+                usp.append(k, serialiseScalar(item));
+            }
+        }
+        else {
+            usp.append(k, serialiseScalar(v));
+        }
+    }
+    const s = usp.toString();
+    return s ? `?${s}` : '';
+}
+function serialiseScalar(v) {
+    if (v instanceof Date)
+        return v.toISOString();
+    if (typeof v === 'boolean')
+        return v ? 'true' : 'false';
+    return String(v);
+}
+//# sourceMappingURL=query.js.map

package/dist/utils/query.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"query.js","sourceRoot":"","sources":["../../src/utils/query.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,MAAM,UAAU,aAAa,CAC3B,MAA2C;IAE3C,IAAI,CAAC,MAAM;QAAE,OAAO,EAAE,CAAC;IACvB,MAAM,GAAG,GAAG,IAAI,eAAe,EAAE,CAAC;IAClC,KAAK,MAAM,CAAC,CAAC,EAAE,CAAC,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC;QAC5C,IAAI,CAAC,KAAK,SAAS,IAAI,CAAC,KAAK,IAAI;YAAE,SAAS;QAC5C,IAAI,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,CAAC;YACrB,KAAK,MAAM,IAAI,IAAI,CAAC,EAAE,CAAC;gBACrB,IAAI,IAAI,KAAK,SAAS,IAAI,IAAI,KAAK,IAAI;oBAAE,SAAS;gBAClD,GAAG,CAAC,MAAM,CAAC,CAAC,EAAE,eAAe,CAAC,IAAI,CAAC,CAAC,CAAC;YACvC,CAAC;QACH,CAAC;aAAM,CAAC;YACN,GAAG,CAAC,MAAM,CAAC,CAAC,EAAE,eAAe,CAAC,CAAC,CAAC,CAAC,CAAC;QACpC,CAAC;IACH,CAAC;IACD,MAAM,CAAC,GAAG,GAAG,CAAC,QAAQ,EAAE,CAAC;IACzB,OAAO,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;AAC1B,CAAC;AAED,SAAS,eAAe,CAAC,CAAU;IACjC,IAAI,CAAC,YAAY,IAAI;QAAE,OAAO,CAAC,CAAC,WAAW,EAAE,CAAC;IAC9C,IAAI,OAAO,CAAC,KAAK,SAAS;QAAE,OAAO,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,OAAO,CAAC;IACxD,OAAO,MAAM,CAAC,CAAC,CAAC,CAAC;AACnB,CAAC"}

package/package.json

@@ -0,0 +1,51 @@
+{
+  "name": "@ethitrust/sdk",
+  "version": "1.0.0",
+  "description": "Official TypeScript/Node SDK for the Ethitrust org-escrows API",
+  "type": "module",
+  "main": "./dist/index.js",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist",
+    "src",
+    "README.md",
+    "LICENSE"
+  ],
+  "keywords": [
+    "ethitrust",
+    "escrow",
+    "sdk",
+    "api",
+    "typescript"
+  ],
+  "author": "Ethitrust",
+  "license": "MIT",
+  "engines": {
+    "node": ">=18"
+  },
+  "devEngines": {
+    "packageManager": {
+      "name": "pnpm",
+      "version": "^11.1.2",
+      "onFail": "download"
+    }
+  },
+  "devDependencies": {
+    "@types/node": "^22.19.19",
+    "tsx": "^4.22.0",
+    "typescript": "^5.6.3"
+  },
+  "scripts": {
+    "build": "tsc -p tsconfig.json",
+    "clean": "rm -rf dist",
+    "test": "node --test test/*.test.mjs",
+    "example": "tsx examples/basic.ts"
+  }
+}

package/src/client.ts

@@ -0,0 +1,69 @@
+import { HttpClient, type HttpClientOptions } from './http.js';
+import { OrgEscrowsResource } from './resources/orgEscrows.js';
+
+export interface EthitrustClientOptions {
+  /** Organization API key. Sent as `X-API-Key` (configurable). */
+  apiKey: string;
+  /**
+   * Base URL. Defaults to `https://api.ethitrust.me`. Accepts host with or
+   * without scheme — if missing, `https://` is assumed.
+   */
+  baseUrl?: string;
+  /** Header carrying the API key. Defaults to `X-API-Key`. */
+  apiKeyHeader?: string;
+  /** Per-request timeout (ms). Defaults to 30 000. */
+  timeoutMs?: number;
+  /** Max retries for transient failures (GET / 429 / 5xx). Defaults to 2. */
+  maxRetries?: number;
+  /** Custom fetch (e.g. undici, node-fetch). */
+  fetch?: typeof fetch;
+  /** Extra headers applied to every request. */
+  defaultHeaders?: Record<string, string>;
+  /** User agent string. */
+  userAgent?: string;
+}
+
+const DEFAULT_BASE_URL = 'https://api.ethitrust.me';
+
+/**
+ * Top-level entry point.
+ *
+ * ```ts
+ * import { EthitrustClient } from '@ethitrust/sdk';
+ * const client = new EthitrustClient({ apiKey: process.env.ETHITRUST_API_KEY! });
+ * const escrow = await client.orgEscrows.create({
+ *   invitee_email: 'buyer@example.com',
+ *   title: 'Website redesign',
+ *   amount: 5000,
+ * });
+ * ```
+ */
+export class EthitrustClient {
+  readonly http: HttpClient;
+  readonly orgEscrows: OrgEscrowsResource;
+
+  constructor(opts: EthitrustClientOptions) {
+    if (!opts.apiKey) {
+      throw new Error('EthitrustClient: `apiKey` is required.');
+    }
+    const baseUrl = normaliseBaseUrl(opts.baseUrl ?? DEFAULT_BASE_URL);
+    const httpOpts: HttpClientOptions = {
+      apiKey: opts.apiKey,
+      apiKeyHeader: opts.apiKeyHeader,
+      baseUrl,
+      timeoutMs: opts.timeoutMs,
+      maxRetries: opts.maxRetries,
+      fetch: opts.fetch,
+      defaultHeaders: opts.defaultHeaders,
+      userAgent: opts.userAgent,
+    };
+    this.http = new HttpClient(httpOpts);
+    this.orgEscrows = new OrgEscrowsResource(this.http);
+  }
+}
+
+function normaliseBaseUrl(input: string): string {
+  const trimmed = input.trim();
+  if (/^https?:\/\//i.test(trimmed)) return trimmed;
+  return `https://${trimmed}`;
+}

package/src/errors.ts

@@ -0,0 +1,140 @@
+import type { HTTPValidationError, ValidationErrorItem } from './types.js';
+
+/** Base class for every error thrown by the SDK. */
+export class EthitrustError extends Error {
+  constructor(message: string) {
+    super(message);
+    this.name = 'EthitrustError';
+  }
+}
+
+/** Thrown when the server returns a non-2xx HTTP status. */
+export class EthitrustApiError extends EthitrustError {
+  readonly status: number;
+  readonly statusText: string;
+  readonly requestId?: string;
+  readonly url: string;
+  readonly method: string;
+  readonly body: unknown;
+
+  constructor(opts: {
+    status: number;
+    statusText: string;
+    url: string;
+    method: string;
+    body: unknown;
+    requestId?: string;
+    message?: string;
+  }) {
+    const detail =
+      opts.message ??
+      extractMessage(opts.body) ??
+      `${opts.status} ${opts.statusText}`;
+    super(`Ethitrust API error ${opts.status}: ${detail}`);
+    this.name = 'EthitrustApiError';
+    this.status = opts.status;
+    this.statusText = opts.statusText;
+    this.url = opts.url;
+    this.method = opts.method;
+    this.body = opts.body;
+    this.requestId = opts.requestId;
+  }
+}
+
+/** 422 Unprocessable Entity (FastAPI validation failure). */
+export class EthitrustValidationError extends EthitrustApiError {
+  readonly errors: ValidationErrorItem[];
+
+  constructor(opts: ConstructorParameters<typeof EthitrustApiError>[0]) {
+    super(opts);
+    this.name = 'EthitrustValidationError';
+    const body = opts.body as HTTPValidationError | undefined;
+    this.errors = body?.detail ?? [];
+  }
+}
+
+/** 401 / 403 — invalid or insufficient credentials. */
+export class EthitrustAuthError extends EthitrustApiError {
+  constructor(opts: ConstructorParameters<typeof EthitrustApiError>[0]) {
+    super(opts);
+    this.name = 'EthitrustAuthError';
+  }
+}
+
+/** 404. */
+export class EthitrustNotFoundError extends EthitrustApiError {
+  constructor(opts: ConstructorParameters<typeof EthitrustApiError>[0]) {
+    super(opts);
+    this.name = 'EthitrustNotFoundError';
+  }
+}
+
+/** 409 — idempotency or business-rule conflict. */
+export class EthitrustConflictError extends EthitrustApiError {
+  constructor(opts: ConstructorParameters<typeof EthitrustApiError>[0]) {
+    super(opts);
+    this.name = 'EthitrustConflictError';
+  }
+}
+
+/** 429 — too many requests. */
+export class EthitrustRateLimitError extends EthitrustApiError {
+  readonly retryAfter?: number;
+  constructor(
+    opts: ConstructorParameters<typeof EthitrustApiError>[0] & {
+      retryAfter?: number;
+    },
+  ) {
+    super(opts);
+    this.name = 'EthitrustRateLimitError';
+    this.retryAfter = opts.retryAfter;
+  }
+}
+
+/** Network / fetch / timeout level failure. */
+export class EthitrustNetworkError extends EthitrustError {
+  readonly cause?: unknown;
+  constructor(message: string, cause?: unknown) {
+    super(message);
+    this.name = 'EthitrustNetworkError';
+    this.cause = cause;
+  }
+}
+
+/** Request was aborted (timeout or user signal). */
+export class EthitrustAbortError extends EthitrustError {
+  constructor(message = 'Request aborted') {
+    super(message);
+    this.name = 'EthitrustAbortError';
+  }
+}
+
+function extractMessage(body: unknown): string | undefined {
+  if (!body || typeof body !== 'object') return undefined;
+  const b = body as Record<string, unknown>;
+  if (typeof b.message === 'string') return b.message;
+  if (typeof b.error === 'string') return b.error;
+  if (typeof b.detail === 'string') return b.detail;
+  if (Array.isArray(b.detail) && b.detail.length > 0) {
+    const first = b.detail[0] as ValidationErrorItem;
+    return `${first.msg} (at ${first.loc?.join('.') ?? '?'})`;
+  }
+  return undefined;
+}
+
+export function buildApiError(opts: {
+  status: number;
+  statusText: string;
+  url: string;
+  method: string;
+  body: unknown;
+  requestId?: string;
+  retryAfter?: number;
+}): EthitrustApiError {
+  if (opts.status === 401 || opts.status === 403) return new EthitrustAuthError(opts);
+  if (opts.status === 404) return new EthitrustNotFoundError(opts);
+  if (opts.status === 409) return new EthitrustConflictError(opts);
+  if (opts.status === 422) return new EthitrustValidationError(opts);
+  if (opts.status === 429) return new EthitrustRateLimitError(opts);
+  return new EthitrustApiError(opts);
+}