Client

The Client is the primary interface for executing HTTP requests in @t-req/core.

createClient

Creates a new client instance.

import { createClient } from '@t-req/core';
import { createNodeIO } from '@t-req/core/runtime';

const client = createClient({
  io: createNodeIO(),
  variables: { baseUrl: 'https://api.example.com' },
});

Options

Option	Type	Description
io	IO	Filesystem adapter for file operations. Required in Node.js for run().
transport	Transport	HTTP transport adapter. Defaults to fetch-based transport.
variables	Record<string, unknown>	Initial variables available to all requests.
resolvers	Record<string, Resolver>	Custom resolver functions for dynamic values.
cookieJar	CookieJar	Cookie jar for automatic cookie management.
timeout	number	Default timeout in milliseconds for all requests.
defaults	RequestDefaults	Default headers and request settings.

RequestDefaults

interface RequestDefaults {
  headers?: Record<string, string>;
  followRedirects?: boolean;
  validateSSL?: boolean;
}

Client Methods

run(path, options?)

Execute a request from a .http file.

const response = await client.run('./api/users.http');

// With options
const response = await client.run('./api/user.http', {
  variables: { userId: '123' },
  timeout: 5000,
  signal: controller.signal,
});

Parameters

Parameter	Type	Description
path	string	Path to the .http file
options	RunOptions	Optional request configuration

RunOptions

interface RunOptions {
  variables?: Record<string, unknown>;
  timeout?: number;
  signal?: AbortSignal;
}

Returns

Promise<Response> - Standard Fetch API Response object.

runString(content, options?)

Execute a request from in-memory .http content.

const response = await client.runString(`
GET https://api.example.com/users/{{userId}}
Authorization: Bearer {{token}}
`, {
  variables: { userId: '123', token: 'abc' },
});

Parameters

Parameter	Type	Description
content	string	The .http file content
options	RunOptions	Optional request configuration

Returns

Promise<Response> - Standard Fetch API Response object.

setVariable(key, value)

Set a single variable.

client.setVariable('token', 'new-jwt-token');
client.setVariable('userId', 123);

setVariables(variables)

Set multiple variables at once.

client.setVariables({
  token: 'new-token',
  userId: 123,
  env: 'production',
});

getVariables()

Get all current variables.

const vars = client.getVariables();
console.log(vars);
// { baseUrl: 'https://...', token: '...', userId: 123 }

Full Example

import { createClient } from '@t-req/core';
import { createNodeIO } from '@t-req/core/runtime';
import { createCookieJar } from '@t-req/core/cookies';

const client = createClient({
  io: createNodeIO(),

  variables: {
    baseUrl: 'https://api.example.com',
  },

  resolvers: {
    $env: (key) => process.env[key] || '',
    $timestamp: () => String(Date.now()),
    $uuid: () => crypto.randomUUID(),
  },

  cookieJar: createCookieJar(),

  timeout: 30000,

  defaults: {
    headers: {
      'User-Agent': 'my-app/1.0',
      'Accept': 'application/json',
    },
    followRedirects: true,
    validateSSL: true,
  },
});

// Login
const loginResponse = await client.run('./auth/login.http');
const { token } = await loginResponse.json();
client.setVariable('token', token);

// Use authenticated API
const usersResponse = await client.run('./api/users.http');
const users = await usersResponse.json();

TypeScript Types

import type { Client, ClientConfig, RunOptions } from '@t-req/core';