TypeScript SDK

npm install @expys/sdk

bun add @expys/sdk

yarn add @expys/sdk

pnpm add @expys/sdk

import { initialize } from "@expys/sdk";

const token = process.env.EXPYS_MEMBER_TOKEN;
if (!token) {
  throw new Error(
    "Set EXPYS_MEMBER_TOKEN (a member token from your backend's /v1/auth/exchange)",
  );
}

// A custom fetch wrapper: log each request, then delegate to the platform fetch.
// Use this seam for tracing, metrics, or a polyfill on Node < 18. The cast keeps
// it simple here under bun-types (whose `fetch` carries extra members); in a
// typical web/Node project the arrow satisfies `typeof fetch` without a cast.
const instrumentedFetch = ((input, init) => {
  const method = init?.method ?? "GET";
  const url =
    typeof input === "string"
      ? input
      : input instanceof URL
        ? input.href
        : input.url;
  console.log(`-> ${method} ${url}`);
  return fetch(input, init);
}) as typeof fetch;

const expys = initialize({
  baseUrl: process.env.EXPYS_BASE_URL,
  environment: "sandbox",
  fetch: instrumentedFetch,
  // Retry 429/5xx up to 3 extra times (4 attempts total) with backoff.
  maxRetries: 3,
  // Abort any single attempt that exceeds 8s.
  timeoutMs: 8_000,
  token,
});

async function main(): Promise<void> {
  const { data } = await expys.listOffers({ limit: 3 });
  console.log(`fetched ${data.length} offers with the configured client`);
}

import ExpysSDK
import Foundation

#if canImport(FoundationNetworking)
  import FoundationNetworking
#endif

/// A custom HTTP layer that logs each request, then delegates to URLSession. Use
/// this seam (the `httpClient` injection point) for tracing, metrics, or a custom
/// transport - the Swift analogue of the TS example's instrumented `fetch`.
struct InstrumentedHTTP: HTTPRequesting {
  func data(for request: URLRequest) async throws -> (Data, URLResponse) {
    print("-> \(request.httpMethod ?? "GET") \(request.url?.absoluteString ?? "")")
    return try await URLSession.shared.data(for: request)
  }
}

@main
struct ConfigurationExample {
  static func main() async throws {
    let environment = ProcessInfo.processInfo.environment
    guard let token = environment["EXPYS_MEMBER_TOKEN"] else {
      fatalError("Set EXPYS_MEMBER_TOKEN (a member token from your backend's /v1/auth/exchange)")
    }
    let baseURL =
      environment["EXPYS_BASE_URL"].flatMap(URL.init(string:))
      ?? ExpysConfiguration.defaultBaseURL

    let client = ExpysClient(
      configuration: ExpysConfiguration(
        token: token,
        environment: .sandbox,
        baseURL: baseURL,
        // Retry 429/5xx up to 3 extra times (4 attempts total) with backoff.
        maxRetries: 3,
        // Abort any single attempt that exceeds 8s.
        timeout: 8
      ),
      httpClient: InstrumentedHTTP()
    )

    let offers = try await client.listOffers(limit: 3)
    print("fetched \(offers.data.count) offers with the configured client")
  }
}

package com.expys.sdk.examples.configuration

import com.expys.sdk.ExpysClient
import com.expys.sdk.ExpysConfiguration
import com.expys.sdk.ExpysEnvironment
import kotlinx.coroutines.runBlocking

fun main() = runBlocking {
  val token = System.getenv("EXPYS_MEMBER_TOKEN")
    ?: error("Set EXPYS_MEMBER_TOKEN (a member token from your backend's /v1/auth/exchange)")

  val client = ExpysClient.create(
    ExpysConfiguration(
      token = token,
      environment = ExpysEnvironment.SANDBOX,
      baseUrl = System.getenv("EXPYS_BASE_URL") ?: ExpysConfiguration.DEFAULT_BASE_URL,
      orgId = System.getenv("EXPYS_ORG_ID"),
      maxRetries = 3,
      timeoutMs = 10_000,
      refreshSkewMs = 30_000,
      userAgentSuffix = "my-app/1.0",
    ),
  )

  println("offers: ${client.listOffers(limit = 1).`data`.size}")
}