SDKs and HTTP clients

The public contract is HTTP with a bearer credential. Curl examples work without a Feeef SDK. The TypeScript and Dart examples elsewhere in these guides refer to repository SDKs, not verified public npm or pub.dev releases.

Repository SDKs

The Cloud workspace contains packages/sdk-ts (package name @cloud/sdk, currently private) and packages/sdk-dart. Use them through your workspace or a local package dependency. Do not install the previously documented @cloud/sdk package or assume a public Dart Git repository exists.

import { CloudClient } from '@cloud/sdk'
const client = new CloudClient({ apiKey: process.env.FEEEF_CLOUD_KEY! })
const countries = await client.geo.countries.list()

The wrappers provide commerce resources, pagination, typed errors and webhook verification. Return shapes differ between convenience methods and generated methods: some unwrap data, while others return the full envelope. Check the method type before accessing a response.

Use explicit stable idempotency keys for writes. Automatic retries are not a substitute for checking an uncertain carrier or provider outcome.

AI with the OpenAI client

The OpenAI Node client can target compatible Feeef endpoints. It does not expose Feeef task creation, native Google payloads, project controls or billing management; use HTTP for those.

import OpenAI from 'openai'
const client = new OpenAI({
  apiKey: process.env.FEEEF_CLOUD_KEY,
  baseURL: 'https://apis.cloud.feeef.org/v1',
  maxRetries: 0,
})

See the AI quickstart for a complete request and compatibility boundaries. Keep project credentials on your server. The trusted Cloud playground accepts them temporarily in memory.