npm install @systemoperator/gateway

import { ApiGateway } from '@systemoperator/gateway';
const gateway = new ApiGateway({
  name: 'linear',
  baseUrl: 'https://api.linear.app',
  tokenProvider: { getToken: (connectionId) => loadFromDb(connectionId) },
  logger: myRequestLogger,        // optional
  responseStore: myR2Store,        // optional
  retry: { maxRetries: 5 },       // optional, has defaults
});

const result = await gateway.fetch<IssueData>('/rest/issues', { method: 'GET' }, connectionId, ctx);

const result = await gateway.graphql<IssueData>(query, variables, connectionId, ctx);

import { paginators } from '@systemoperator/gateway';
const allItems = await gateway.paginate<Issue>('/rest/issues', paginators.notion(), connectionId, ctx);

import type { TokenProvider, RequestLogger, ResponseStore } from '@systemoperator/gateway';
const tokenProvider: TokenProvider = {
  async getToken(connectionId) { /* load from DB */ },
};
const logger: RequestLogger = {
  async log(entry) { /* insert into request_logs table */ },
};
const responseStore: ResponseStore = {
  async store(gatewayName, reqId, data) { /* store in R2/S3/disk */ },
};

import { createR2ResponseStore } from '@systemoperator/gateway/r2';
const responseStore = createR2ResponseStore(env.R2_BUCKET);

import { retryFetch, extractShape, countRecords } from '@systemoperator/gateway';
// standalone retry fetch
const result = await retryFetch<Data>(url, options, { maxRetries: 3 });
// response shape extraction for logging
const shape = extractShape(responseData);
const count = countRecords(responseData);