@hardlydifficult/rest-client 1.0.0

package/dist/AuthenticationManager.d.ts

@@ -0,0 +1,18 @@
+import type { AuthConfig, RestClientLogger } from "./types";
+/** Manages token lifecycle for all supported auth strategies. */
+export declare class AuthenticationManager {
+    private readonly authConfig;
+    private readonly logger?;
+    private bearerToken;
+    private tokenExpiry;
+    private tokenIssuedAt;
+    constructor(authConfig: AuthConfig, logger?: RestClientLogger | undefined);
+    authenticate(): Promise<string>;
+    clearToken(): void;
+    getTokenExpiryTime(): number | null;
+    getTokenIssuedAt(): number | null;
+    getTokenLifetimeMs(): number | null;
+    private authenticateOAuth2;
+    private isTokenValid;
+}
+//# sourceMappingURL=AuthenticationManager.d.ts.map

package/dist/AuthenticationManager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"AuthenticationManager.d.ts","sourceRoot":"","sources":["../src/AuthenticationManager.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,UAAU,EAAc,gBAAgB,EAAE,MAAM,SAAS,CAAC;AASxE,iEAAiE;AACjE,qBAAa,qBAAqB;IAM9B,OAAO,CAAC,QAAQ,CAAC,UAAU;IAC3B,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAC;IAN1B,OAAO,CAAC,WAAW,CAAuB;IAC1C,OAAO,CAAC,WAAW,CAAuB;IAC1C,OAAO,CAAC,aAAa,CAAuB;gBAGzB,UAAU,EAAE,UAAU,EACtB,MAAM,CAAC,EAAE,gBAAgB,YAAA;IAGtC,YAAY,IAAI,OAAO,CAAC,MAAM,CAAC;IA+BrC,UAAU,IAAI,IAAI;IAMlB,kBAAkB,IAAI,MAAM,GAAG,IAAI;IAInC,gBAAgB,IAAI,MAAM,GAAG,IAAI;IAIjC,kBAAkB,IAAI,MAAM,GAAG,IAAI;YAOrB,kBAAkB;IA4FhC,OAAO,CAAC,YAAY;CAerB"}

package/dist/AuthenticationManager.js

@@ -0,0 +1,134 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AuthenticationManager = void 0;
+const axios_1 = __importDefault(require("axios"));
+const errors_1 = require("./errors");
+/** Manages token lifecycle for all supported auth strategies. */
+class AuthenticationManager {
+    authConfig;
+    logger;
+    bearerToken = null;
+    tokenExpiry = null;
+    tokenIssuedAt = null;
+    constructor(authConfig, logger) {
+        this.authConfig = authConfig;
+        this.logger = logger;
+    }
+    async authenticate() {
+        if (this.isTokenValid() && this.bearerToken !== null) {
+            return this.bearerToken;
+        }
+        switch (this.authConfig.type) {
+            case "none":
+                return "";
+            case "bearer":
+                this.bearerToken = this.authConfig.token;
+                return this.bearerToken;
+            case "generator": {
+                this.bearerToken = await this.authConfig.generate();
+                this.tokenIssuedAt = Date.now();
+                this.tokenExpiry =
+                    this.tokenIssuedAt + (this.authConfig.cacheDurationMs ?? 60_000);
+                return this.bearerToken;
+            }
+            case "oauth2":
+                return this.authenticateOAuth2(this.authConfig);
+            default:
+                throw new errors_1.AuthenticationError(`Unsupported auth type: ${this.authConfig.type}`);
+        }
+    }
+    clearToken() {
+        this.bearerToken = null;
+        this.tokenExpiry = null;
+        this.tokenIssuedAt = null;
+    }
+    getTokenExpiryTime() {
+        return this.tokenExpiry;
+    }
+    getTokenIssuedAt() {
+        return this.tokenIssuedAt;
+    }
+    getTokenLifetimeMs() {
+        if (this.tokenIssuedAt === null || this.tokenExpiry === null) {
+            return null;
+        }
+        return this.tokenExpiry - this.tokenIssuedAt;
+    }
+    async authenticateOAuth2(config) {
+        const grantType = config.grantType ?? "client_credentials";
+        const formData = new URLSearchParams();
+        formData.append("grant_type", grantType);
+        formData.append("client_id", config.clientId);
+        if (grantType === "client_credentials" &&
+            config.clientSecret !== undefined &&
+            config.clientSecret !== "") {
+            formData.append("client_secret", config.clientSecret);
+        }
+        if (config.audience !== undefined && config.audience !== "") {
+            formData.append("audience", config.audience);
+        }
+        if (config.scope !== undefined && config.scope !== "") {
+            formData.append("scope", config.scope);
+        }
+        if (grantType === "password") {
+            if (config.username === undefined ||
+                config.username === "" ||
+                config.password === undefined ||
+                config.password === "") {
+                throw new errors_1.AuthenticationError("Password grant requires username and password");
+            }
+            formData.append("username", config.username);
+            formData.append("password", config.password);
+        }
+        try {
+            const response = await axios_1.default.post(config.tokenUrl, formData.toString(), { headers: { "Content-Type": "application/x-www-form-urlencoded" } });
+            if (response.data.access_token === undefined ||
+                response.data.access_token === "") {
+                throw new errors_1.AuthenticationError(`Authentication response missing access_token from ${config.tokenUrl}`);
+            }
+            this.bearerToken = response.data.access_token;
+            this.tokenIssuedAt = Date.now();
+            if (response.data.expires_in !== undefined &&
+                response.data.expires_in !== 0) {
+                this.tokenExpiry = this.tokenIssuedAt + response.data.expires_in * 1000;
+            }
+            this.logger?.debug?.("OAuth2 token acquired", {
+                tokenUrl: config.tokenUrl,
+                expiresIn: response.data.expires_in,
+            });
+            return this.bearerToken;
+        }
+        catch (error) {
+            if (error instanceof errors_1.AuthenticationError) {
+                throw error;
+            }
+            if (axios_1.default.isAxiosError(error)) {
+                const status = error.response?.status;
+                const errorData = error.response?.data !== undefined
+                    ? JSON.stringify(error.response.data, null, 2)
+                    : error.message;
+                throw new errors_1.HttpError(`Authentication failed for ${config.tokenUrl}: ${String(status)} ${errorData}`, status, error.response?.statusText);
+            }
+            throw new errors_1.AuthenticationError(`Authentication failed for ${config.tokenUrl}: ${error instanceof Error ? error.message : String(error)}`);
+        }
+    }
+    isTokenValid() {
+        if (this.bearerToken === null) {
+            return false;
+        }
+        if (this.tokenExpiry === null) {
+            return true;
+        }
+        const lifetimeMs = this.getTokenLifetimeMs();
+        const defaultBufferMs = 5 * 60 * 1000;
+        const bufferMs = lifetimeMs !== null
+            ? Math.min(defaultBufferMs, Math.floor(lifetimeMs / 2))
+            : defaultBufferMs;
+        return Date.now() < this.tokenExpiry - bufferMs;
+    }
+}
+exports.AuthenticationManager = AuthenticationManager;
+//# sourceMappingURL=AuthenticationManager.js.map

package/dist/AuthenticationManager.js.map

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

package/dist/HttpClient.d.ts

@@ -0,0 +1,23 @@
+import type { RestClientLogger, RetryConfig } from "./types";
+/** HTTP client with automatic retries and structured error formatting. */
+export declare class HttpClient {
+    private readonly instance;
+    private readonly logger;
+    private readonly retry;
+    constructor(options?: {
+        logger?: RestClientLogger;
+        retry?: RetryConfig;
+        defaultHeaders?: Record<string, string>;
+    });
+    setBearerToken(token: string): void;
+    clearBearerToken(): void;
+    get<T>(url: string): Promise<T>;
+    post<T>(url: string, data?: unknown): Promise<T>;
+    delete<T>(url: string): Promise<T>;
+    patch<T>(url: string, data?: unknown): Promise<T>;
+    put<T>(url: string, data?: unknown): Promise<T>;
+    private withRetry;
+    private isRetryable;
+    private toTypedError;
+}
+//# sourceMappingURL=HttpClient.d.ts.map

package/dist/HttpClient.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"HttpClient.d.ts","sourceRoot":"","sources":["../src/HttpClient.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,gBAAgB,EAAE,WAAW,EAAE,MAAM,SAAS,CAAC;AAW7D,0EAA0E;AAC1E,qBAAa,UAAU;IACrB,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAgB;IACzC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAA+B;IACtD,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAc;gBAExB,OAAO,CAAC,EAAE;QACpB,MAAM,CAAC,EAAE,gBAAgB,CAAC;QAC1B,KAAK,CAAC,EAAE,WAAW,CAAC;QACpB,cAAc,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;KACzC;IAWD,cAAc,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI;IAInC,gBAAgB,IAAI,IAAI;IAIlB,GAAG,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,CAAC,CAAC;IAI/B,IAAI,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,OAAO,GAAG,OAAO,CAAC,CAAC,CAAC;IAIhD,MAAM,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,CAAC,CAAC;IAIlC,KAAK,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,OAAO,GAAG,OAAO,CAAC,CAAC,CAAC;IAMjD,GAAG,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,OAAO,GAAG,OAAO,CAAC,CAAC,CAAC;YAIvC,SAAS;IA6BvB,OAAO,CAAC,WAAW;IAyBnB,OAAO,CAAC,YAAY;CAoDrB"}

package/dist/HttpClient.js

@@ -0,0 +1,174 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.HttpClient = void 0;
+const axios_1 = __importDefault(require("axios"));
+const errors_1 = require("./errors");
+const DEFAULT_RETRY = {
+    maxAttempts: 3,
+    delayMs: 6000,
+};
+const CAUSE_TRUNCATE = 200;
+const CONTEXT_VALUE_TRUNCATE = 50;
+const MAX_CONTEXT_KEYS = 3;
+/** HTTP client with automatic retries and structured error formatting. */
+class HttpClient {
+    instance;
+    logger;
+    retry;
+    constructor(options) {
+        this.instance = axios_1.default.create({
+            headers: {
+                "Content-Type": "application/json",
+                ...options?.defaultHeaders,
+            },
+        });
+        this.logger = options?.logger;
+        this.retry = { ...DEFAULT_RETRY, ...options?.retry };
+    }
+    setBearerToken(token) {
+        this.instance.defaults.headers.common.Authorization = `Bearer ${token}`;
+    }
+    clearBearerToken() {
+        delete this.instance.defaults.headers.common.Authorization;
+    }
+    async get(url) {
+        return this.withRetry("GET", url, () => this.instance.get(url));
+    }
+    async post(url, data) {
+        return this.withRetry("POST", url, () => this.instance.post(url, data));
+    }
+    async delete(url) {
+        return this.withRetry("DELETE", url, () => this.instance.delete(url));
+    }
+    async patch(url, data) {
+        return this.withRetry("PATCH", url, () => this.instance.patch(url, data));
+    }
+    async put(url, data) {
+        return this.withRetry("PUT", url, () => this.instance.put(url, data));
+    }
+    async withRetry(method, url, fn, attempt = 0) {
+        try {
+            const response = await fn();
+            this.logger?.debug?.(`${method} ${url}`, {
+                status: response.status ?? 200,
+            });
+            return response.data;
+        }
+        catch (error) {
+            if (attempt < this.retry.maxAttempts && this.isRetryable(error)) {
+                this.logger?.warn?.(`${method} ${url} failed, retrying (${String(attempt + 1)}/${String(this.retry.maxAttempts)})`, {
+                    error: axios_1.default.isAxiosError(error)
+                        ? (error.response?.status ?? "network")
+                        : String(error),
+                });
+                await sleep(this.retry.delayMs);
+                return this.withRetry(method, url, fn, attempt + 1);
+            }
+            throw this.toTypedError(error);
+        }
+    }
+    isRetryable(error) {
+        if (!axios_1.default.isAxiosError(error)) {
+            return error instanceof errors_1.NetworkError;
+        }
+        const status = error.response?.status;
+        if (status === undefined) {
+            return true;
+        }
+        if (status >= 500 && status < 600) {
+            return true;
+        }
+        if (this.retry.retryableStatuses?.includes(status) === true) {
+            return true;
+        }
+        if (this.retry.isRetryable !== undefined) {
+            const body = (error.response?.data ?? {});
+            return this.retry.isRetryable(status, body);
+        }
+        return false;
+    }
+    toTypedError(error) {
+        if (axios_1.default.isAxiosError(error)) {
+            if (error.response === undefined) {
+                return new errors_1.NetworkError(`Request failed: ${error.message}`, error.code !== undefined ? { code: error.code } : undefined);
+            }
+            const { status } = error.response;
+            const { statusText } = error.response;
+            const data = error.response.data ?? {};
+            const code = typeof data.code === "string" ? data.code : undefined;
+            const message = typeof data.message === "string" ? data.message : undefined;
+            const cause = typeof data.cause === "string" ? data.cause : undefined;
+            const context = typeof data.context === "object" &&
+                data.context !== null &&
+                !Array.isArray(data.context)
+                ? data.context
+                : undefined;
+            let msg = `HTTP ${String(status)}`;
+            if (code !== undefined) {
+                msg += `: ${code}`;
+            }
+            if (message !== undefined) {
+                msg += ` - ${message}`;
+            }
+            if (cause !== undefined) {
+                const truncated = cause.length > CAUSE_TRUNCATE
+                    ? `${cause.substring(0, CAUSE_TRUNCATE)}...`
+                    : cause;
+                msg += ` (cause: ${truncated})`;
+            }
+            if (context !== undefined) {
+                const summary = formatContextSummary(context);
+                if (summary !== undefined) {
+                    msg += ` [context: ${summary}]`;
+                }
+            }
+            return new errors_1.HttpError(msg, status, statusText, data);
+        }
+        return new errors_1.NetworkError(`Request failed: ${error instanceof Error ? error.message : String(error)}`);
+    }
+}
+exports.HttpClient = HttpClient;
+function sleep(ms) {
+    return new Promise((resolve) => {
+        setTimeout(resolve, ms);
+    });
+}
+function formatContextSummary(obj) {
+    const keys = Object.keys(obj);
+    if (keys.length === 0) {
+        return undefined;
+    }
+    return keys
+        .slice(0, MAX_CONTEXT_KEYS)
+        .map((k) => {
+        const v = obj[k];
+        const str = stringifyValue(v);
+        return `${k}=${str.length > CONTEXT_VALUE_TRUNCATE ? `${str.substring(0, CONTEXT_VALUE_TRUNCATE)}...` : str}`;
+    })
+        .join(", ");
+}
+function stringifyValue(v) {
+    if (typeof v === "string") {
+        return v;
+    }
+    if (v === null) {
+        return "null";
+    }
+    if (v === undefined) {
+        return "undefined";
+    }
+    return safeStringify(v);
+}
+function safeStringify(v) {
+    try {
+        const result = JSON.stringify(v);
+        return typeof result === "string" ? result : "[Object]";
+    }
+    catch {
+        return "[Object]";
+    }
+}
+//# sourceMappingURL=HttpClient.js.map

package/dist/HttpClient.js.map

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

package/dist/Operation.d.ts

@@ -0,0 +1,24 @@
+import { z } from "zod";
+import type { HttpMethod } from "./types";
+/** Declarative configuration for a REST operation. */
+export interface OperationConfig<Params, Response> {
+    readonly params: z.ZodType<Params>;
+    readonly method: HttpMethod;
+    readonly url: (params: Params, baseUrl: string) => string;
+    readonly body?: (params: Params) => Record<string, unknown> | string | undefined;
+    readonly transform?: (response: Response) => Response;
+}
+/**
+ * Define a REST operation declaratively.
+ *
+ * @example
+ *   const GetUser = defineOperation<{ id: string }, User>({
+ *     params: z.object({ id: z.string() }),
+ *     method: "GET",
+ *     url: (p, base) => `${base}/users/${p.id}`,
+ *   });
+ */
+export declare function defineOperation<Params, Response>(config: OperationConfig<Params, Response>): OperationConfig<Params, Response>;
+/** Validate params against a Zod schema, throwing ValidationError on failure. */
+export declare function validateParams<T>(params: T, schema: z.ZodType<T>): T;
+//# sourceMappingURL=Operation.d.ts.map

package/dist/Operation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Operation.d.ts","sourceRoot":"","sources":["../src/Operation.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AAE1C,sDAAsD;AACtD,MAAM,WAAW,eAAe,CAAC,MAAM,EAAE,QAAQ;IAC/C,QAAQ,CAAC,MAAM,EAAE,CAAC,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC;IACnC,QAAQ,CAAC,MAAM,EAAE,UAAU,CAAC;IAC5B,QAAQ,CAAC,GAAG,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,KAAK,MAAM,CAAC;IAC1D,QAAQ,CAAC,IAAI,CAAC,EAAE,CACd,MAAM,EAAE,MAAM,KACX,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM,GAAG,SAAS,CAAC;IAClD,QAAQ,CAAC,SAAS,CAAC,EAAE,CAAC,QAAQ,EAAE,QAAQ,KAAK,QAAQ,CAAC;CACvD;AAED;;;;;;;;;GASG;AACH,wBAAgB,eAAe,CAAC,MAAM,EAAE,QAAQ,EAC9C,MAAM,EAAE,eAAe,CAAC,MAAM,EAAE,QAAQ,CAAC,GACxC,eAAe,CAAC,MAAM,EAAE,QAAQ,CAAC,CAEnC;AAED,iFAAiF;AACjF,wBAAgB,cAAc,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,GAAG,CAAC,CAWpE"}

package/dist/Operation.js

@@ -0,0 +1,32 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.defineOperation = defineOperation;
+exports.validateParams = validateParams;
+const zod_1 = require("zod");
+const errors_1 = require("./errors");
+/**
+ * Define a REST operation declaratively.
+ *
+ * @example
+ *   const GetUser = defineOperation<{ id: string }, User>({
+ *     params: z.object({ id: z.string() }),
+ *     method: "GET",
+ *     url: (p, base) => `${base}/users/${p.id}`,
+ *   });
+ */
+function defineOperation(config) {
+    return config;
+}
+/** Validate params against a Zod schema, throwing ValidationError on failure. */
+function validateParams(params, schema) {
+    try {
+        return schema.parse(params);
+    }
+    catch (error) {
+        if (error instanceof zod_1.z.ZodError) {
+            throw new errors_1.ValidationError(`Parameter validation failed: ${error.issues.map((e) => `${e.path.join(".")}: ${e.message}`).join(", ")}`);
+        }
+        throw error;
+    }
+}
+//# sourceMappingURL=Operation.js.map

package/dist/Operation.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Operation.js","sourceRoot":"","sources":["../src/Operation.ts"],"names":[],"mappings":";;AA0BA,0CAIC;AAGD,wCAWC;AA5CD,6BAAwB;AAExB,qCAA2C;AAc3C;;;;;;;;;GASG;AACH,SAAgB,eAAe,CAC7B,MAAyC;IAEzC,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,iFAAiF;AACjF,SAAgB,cAAc,CAAI,MAAS,EAAE,MAAoB;IAC/D,IAAI,CAAC;QACH,OAAO,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;IAC9B,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,IAAI,KAAK,YAAY,OAAC,CAAC,QAAQ,EAAE,CAAC;YAChC,MAAM,IAAI,wBAAe,CACvB,gCAAgC,KAAK,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAC1G,CAAC;QACJ,CAAC;QACD,MAAM,KAAK,CAAC;IACd,CAAC;AACH,CAAC"}

package/dist/RestClient.d.ts

@@ -0,0 +1,54 @@
+import { type OperationConfig } from "./Operation";
+import type { RestClientConfig, RestClientLogger } from "./types";
+/**
+ * Opinionated REST client with OAuth2, retries, and declarative operations.
+ *
+ * @example
+ *   class MyApi extends RestClient {
+ *     getUser = this.bind(GetUser);
+ *     createUser = this.bind(CreateUser);
+ *   }
+ *
+ *   const api = new MyApi({
+ *     baseUrl: "https://api.example.com",
+ *     auth: { type: "oauth2", tokenUrl: "...", clientId: "...", clientSecret: "..." },
+ *   });
+ *
+ *   const user = await api.getUser({ id: "123" });
+ */
+export declare class RestClient {
+    private readonly httpClient;
+    private readonly authManager;
+    private readonly config;
+    constructor(config: RestClientConfig);
+    /** Base URL for all requests. */
+    getBaseUrl(): string;
+    /** Logger instance, if configured. */
+    getLogger(): RestClientLogger | undefined;
+    /**
+     * Bind a declarative operation to this client, returning a typed function.
+     *
+     * @example
+     *   class MyApi extends RestClient {
+     *     getUser = this.bind(GetUser);
+     *   }
+     */
+    bind<Params, Response>(config: OperationConfig<Params, Response>): (params: Params) => Promise<Response>;
+    /** Authenticate and set the bearer token for subsequent requests. */
+    authenticate(): Promise<string>;
+    /** Clear the cached token, forcing re-authentication on next request. */
+    clearToken(): void;
+    /** Token expiry timestamp (ms since epoch), or null if unavailable. */
+    getTokenExpiryTime(): number | null;
+    /** Token issue timestamp (ms since epoch), or null if unavailable. */
+    getTokenIssuedAt(): number | null;
+    /** Token lifetime in milliseconds, or null if unavailable. */
+    getTokenLifetimeMs(): number | null;
+    get<T>(url: string): Promise<T>;
+    post<T>(url: string, data?: unknown): Promise<T>;
+    delete<T>(url: string): Promise<T>;
+    patch<T>(url: string, data?: unknown): Promise<T>;
+    put<T>(url: string, data?: unknown): Promise<T>;
+    private executeMethod;
+}
+//# sourceMappingURL=RestClient.d.ts.map

package/dist/RestClient.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"RestClient.d.ts","sourceRoot":"","sources":["../src/RestClient.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,KAAK,eAAe,EAAkB,MAAM,aAAa,CAAC;AACnE,OAAO,KAAK,EAAc,gBAAgB,EAAE,gBAAgB,EAAE,MAAM,SAAS,CAAC;AAE9E;;;;;;;;;;;;;;;GAeG;AACH,qBAAa,UAAU;IACrB,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAa;IACxC,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAwB;IACpD,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAmB;gBAE9B,MAAM,EAAE,gBAAgB;IAmBpC,iCAAiC;IACjC,UAAU,IAAI,MAAM;IAIpB,sCAAsC;IACtC,SAAS,IAAI,gBAAgB,GAAG,SAAS;IAIzC;;;;;;;OAOG;IACH,IAAI,CAAC,MAAM,EAAE,QAAQ,EACnB,MAAM,EAAE,eAAe,CAAC,MAAM,EAAE,QAAQ,CAAC,GACxC,CAAC,MAAM,EAAE,MAAM,KAAK,OAAO,CAAC,QAAQ,CAAC;IAexC,qEAAqE;IAC/D,YAAY,IAAI,OAAO,CAAC,MAAM,CAAC;IAQrC,yEAAyE;IACzE,UAAU,IAAI,IAAI;IAKlB,uEAAuE;IACvE,kBAAkB,IAAI,MAAM,GAAG,IAAI;IAInC,sEAAsE;IACtE,gBAAgB,IAAI,MAAM,GAAG,IAAI;IAIjC,8DAA8D;IAC9D,kBAAkB,IAAI,MAAM,GAAG,IAAI;IAI7B,GAAG,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,CAAC,CAAC;IAK/B,IAAI,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,OAAO,GAAG,OAAO,CAAC,CAAC,CAAC;IAKhD,MAAM,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,CAAC,CAAC;IAKlC,KAAK,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,OAAO,GAAG,OAAO,CAAC,CAAC,CAAC;IAKjD,GAAG,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,OAAO,GAAG,OAAO,CAAC,CAAC,CAAC;YAKvC,aAAa;CAuB5B"}

package/dist/RestClient.js

@@ -0,0 +1,132 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.RestClient = void 0;
+const AuthenticationManager_1 = require("./AuthenticationManager");
+const errors_1 = require("./errors");
+const HttpClient_1 = require("./HttpClient");
+const Operation_1 = require("./Operation");
+/**
+ * Opinionated REST client with OAuth2, retries, and declarative operations.
+ *
+ * @example
+ *   class MyApi extends RestClient {
+ *     getUser = this.bind(GetUser);
+ *     createUser = this.bind(CreateUser);
+ *   }
+ *
+ *   const api = new MyApi({
+ *     baseUrl: "https://api.example.com",
+ *     auth: { type: "oauth2", tokenUrl: "...", clientId: "...", clientSecret: "..." },
+ *   });
+ *
+ *   const user = await api.getUser({ id: "123" });
+ */
+class RestClient {
+    httpClient;
+    authManager;
+    config;
+    constructor(config) {
+        if (config.baseUrl === "") {
+            throw new errors_1.ConfigurationError("baseUrl is required");
+        }
+        this.config = config;
+        this.authManager = new AuthenticationManager_1.AuthenticationManager(config.auth ?? { type: "none" }, config.logger);
+        this.httpClient = new HttpClient_1.HttpClient({
+            logger: config.logger,
+            retry: config.retry,
+            defaultHeaders: config.defaultHeaders
+                ? { ...config.defaultHeaders }
+                : undefined,
+        });
+    }
+    /** Base URL for all requests. */
+    getBaseUrl() {
+        return this.config.baseUrl;
+    }
+    /** Logger instance, if configured. */
+    getLogger() {
+        return this.config.logger;
+    }
+    /**
+     * Bind a declarative operation to this client, returning a typed function.
+     *
+     * @example
+     *   class MyApi extends RestClient {
+     *     getUser = this.bind(GetUser);
+     *   }
+     */
+    bind(config) {
+        return async (params) => {
+            const validated = (0, Operation_1.validateParams)(params, config.params);
+            const url = config.url(validated, this.getBaseUrl());
+            const response = await this.executeMethod(config.method, url, config.body?.(validated));
+            return config.transform !== undefined
+                ? config.transform(response)
+                : response;
+        };
+    }
+    /** Authenticate and set the bearer token for subsequent requests. */
+    async authenticate() {
+        const token = await this.authManager.authenticate();
+        if (token !== "") {
+            this.httpClient.setBearerToken(token);
+        }
+        return token;
+    }
+    /** Clear the cached token, forcing re-authentication on next request. */
+    clearToken() {
+        this.authManager.clearToken();
+        this.httpClient.clearBearerToken();
+    }
+    /** Token expiry timestamp (ms since epoch), or null if unavailable. */
+    getTokenExpiryTime() {
+        return this.authManager.getTokenExpiryTime();
+    }
+    /** Token issue timestamp (ms since epoch), or null if unavailable. */
+    getTokenIssuedAt() {
+        return this.authManager.getTokenIssuedAt();
+    }
+    /** Token lifetime in milliseconds, or null if unavailable. */
+    getTokenLifetimeMs() {
+        return this.authManager.getTokenLifetimeMs();
+    }
+    async get(url) {
+        await this.authenticate();
+        return this.httpClient.get(url);
+    }
+    async post(url, data) {
+        await this.authenticate();
+        return this.httpClient.post(url, data);
+    }
+    async delete(url) {
+        await this.authenticate();
+        return this.httpClient.delete(url);
+    }
+    async patch(url, data) {
+        await this.authenticate();
+        return this.httpClient.patch(url, data);
+    }
+    async put(url, data) {
+        await this.authenticate();
+        return this.httpClient.put(url, data);
+    }
+    async executeMethod(method, url, data) {
+        await this.authenticate();
+        switch (method) {
+            case "GET":
+                return this.httpClient.get(url);
+            case "POST":
+                return this.httpClient.post(url, data);
+            case "DELETE":
+                return this.httpClient.delete(url);
+            case "PATCH":
+                return this.httpClient.patch(url, data);
+            case "PUT":
+                return this.httpClient.put(url, data);
+            default:
+                throw new errors_1.ConfigurationError(`Unsupported HTTP method: ${method}`);
+        }
+    }
+}
+exports.RestClient = RestClient;
+//# sourceMappingURL=RestClient.js.map

package/dist/RestClient.js.map

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

package/dist/errors.d.ts

@@ -0,0 +1,56 @@
+/** JSON-serializable context for error details. */
+export type ErrorContext = Readonly<Record<string, unknown>>;
+export declare const ErrorCode: {
+    readonly REST_CLIENT_ERROR: "REST_CLIENT_ERROR";
+    readonly CONFIGURATION_ERROR: "CONFIGURATION_ERROR";
+    readonly AUTHENTICATION_ERROR: "AUTHENTICATION_ERROR";
+    readonly HTTP_ERROR: "HTTP_ERROR";
+    readonly VALIDATION_ERROR: "VALIDATION_ERROR";
+    readonly NETWORK_ERROR: "NETWORK_ERROR";
+};
+export type ErrorCodeType = (typeof ErrorCode)[keyof typeof ErrorCode];
+/** Base error for all rest-client errors. */
+export declare class RestClientError extends Error {
+    readonly code: string;
+    readonly context?: ErrorContext | undefined;
+    readonly name: string;
+    constructor(message: string, code: string, context?: ErrorContext | undefined);
+}
+/**
+ *
+ */
+export declare class ConfigurationError extends RestClientError {
+    readonly name = "ConfigurationError";
+    constructor(message: string, context?: ErrorContext);
+}
+/**
+ *
+ */
+export declare class AuthenticationError extends RestClientError {
+    readonly name = "AuthenticationError";
+    constructor(message: string, context?: ErrorContext);
+}
+/**
+ *
+ */
+export declare class HttpError extends RestClientError {
+    readonly status?: number | undefined;
+    readonly statusText?: string | undefined;
+    readonly name = "HttpError";
+    constructor(message: string, status?: number | undefined, statusText?: string | undefined, response?: ErrorContext);
+}
+/**
+ *
+ */
+export declare class ValidationError extends RestClientError {
+    readonly name = "ValidationError";
+    constructor(message: string, context?: ErrorContext);
+}
+/**
+ *
+ */
+export declare class NetworkError extends RestClientError {
+    readonly name = "NetworkError";
+    constructor(message: string, context?: ErrorContext);
+}
+//# sourceMappingURL=errors.d.ts.map

package/dist/errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"AAAA,mDAAmD;AACnD,MAAM,MAAM,YAAY,GAAG,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;AAE7D,eAAO,MAAM,SAAS;;;;;;;CAOZ,CAAC;AAEX,MAAM,MAAM,aAAa,GAAG,CAAC,OAAO,SAAS,CAAC,CAAC,MAAM,OAAO,SAAS,CAAC,CAAC;AAEvE,6CAA6C;AAC7C,qBAAa,eAAgB,SAAQ,KAAK;aAKtB,IAAI,EAAE,MAAM;aACZ,OAAO,CAAC,EAAE,YAAY;IALxC,SAAyB,IAAI,EAAE,MAAM,CAAC;gBAGpC,OAAO,EAAE,MAAM,EACC,IAAI,EAAE,MAAM,EACZ,OAAO,CAAC,EAAE,YAAY,YAAA;CAMzC;AAED;;GAEG;AACH,qBAAa,kBAAmB,SAAQ,eAAe;IACrD,SAAyB,IAAI,wBAAwB;gBAEzC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,YAAY;CAGpD;AAED;;GAEG;AACH,qBAAa,mBAAoB,SAAQ,eAAe;IACtD,SAAyB,IAAI,yBAAyB;gBAE1C,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,YAAY;CAGpD;AAED;;GAEG;AACH,qBAAa,SAAU,SAAQ,eAAe;aAK1B,MAAM,CAAC,EAAE,MAAM;aACf,UAAU,CAAC,EAAE,MAAM;IALrC,SAAyB,IAAI,eAAe;gBAG1C,OAAO,EAAE,MAAM,EACC,MAAM,CAAC,EAAE,MAAM,YAAA,EACf,UAAU,CAAC,EAAE,MAAM,YAAA,EACnC,QAAQ,CAAC,EAAE,YAAY;CAI1B;AAED;;GAEG;AACH,qBAAa,eAAgB,SAAQ,eAAe;IAClD,SAAyB,IAAI,qBAAqB;gBAEtC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,YAAY;CAGpD;AAED;;GAEG;AACH,qBAAa,YAAa,SAAQ,eAAe;IAC/C,SAAyB,IAAI,kBAAkB;gBAEnC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,YAAY;CAGpD"}

package/dist/errors.js

@@ -0,0 +1,80 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.NetworkError = exports.ValidationError = exports.HttpError = exports.AuthenticationError = exports.ConfigurationError = exports.RestClientError = exports.ErrorCode = void 0;
+exports.ErrorCode = {
+    REST_CLIENT_ERROR: "REST_CLIENT_ERROR",
+    CONFIGURATION_ERROR: "CONFIGURATION_ERROR",
+    AUTHENTICATION_ERROR: "AUTHENTICATION_ERROR",
+    HTTP_ERROR: "HTTP_ERROR",
+    VALIDATION_ERROR: "VALIDATION_ERROR",
+    NETWORK_ERROR: "NETWORK_ERROR",
+};
+/** Base error for all rest-client errors. */
+class RestClientError extends Error {
+    code;
+    context;
+    name;
+    constructor(message, code, context) {
+        super(message);
+        this.code = code;
+        this.context = context;
+        this.name = "RestClientError";
+        Object.setPrototypeOf(this, new.target.prototype);
+    }
+}
+exports.RestClientError = RestClientError;
+/**
+ *
+ */
+class ConfigurationError extends RestClientError {
+    name = "ConfigurationError";
+    constructor(message, context) {
+        super(message, exports.ErrorCode.CONFIGURATION_ERROR, context);
+    }
+}
+exports.ConfigurationError = ConfigurationError;
+/**
+ *
+ */
+class AuthenticationError extends RestClientError {
+    name = "AuthenticationError";
+    constructor(message, context) {
+        super(message, exports.ErrorCode.AUTHENTICATION_ERROR, context);
+    }
+}
+exports.AuthenticationError = AuthenticationError;
+/**
+ *
+ */
+class HttpError extends RestClientError {
+    status;
+    statusText;
+    name = "HttpError";
+    constructor(message, status, statusText, response) {
+        super(message, exports.ErrorCode.HTTP_ERROR, response);
+        this.status = status;
+        this.statusText = statusText;
+    }
+}
+exports.HttpError = HttpError;
+/**
+ *
+ */
+class ValidationError extends RestClientError {
+    name = "ValidationError";
+    constructor(message, context) {
+        super(message, exports.ErrorCode.VALIDATION_ERROR, context);
+    }
+}
+exports.ValidationError = ValidationError;
+/**
+ *
+ */
+class NetworkError extends RestClientError {
+    name = "NetworkError";
+    constructor(message, context) {
+        super(message, exports.ErrorCode.NETWORK_ERROR, context);
+    }
+}
+exports.NetworkError = NetworkError;
+//# sourceMappingURL=errors.js.map

package/dist/errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":";;;AAGa,QAAA,SAAS,GAAG;IACvB,iBAAiB,EAAE,mBAAmB;IACtC,mBAAmB,EAAE,qBAAqB;IAC1C,oBAAoB,EAAE,sBAAsB;IAC5C,UAAU,EAAE,YAAY;IACxB,gBAAgB,EAAE,kBAAkB;IACpC,aAAa,EAAE,eAAe;CACtB,CAAC;AAIX,6CAA6C;AAC7C,MAAa,eAAgB,SAAQ,KAAK;IAKtB;IACA;IALO,IAAI,CAAS;IAEtC,YACE,OAAe,EACC,IAAY,EACZ,OAAsB;QAEtC,KAAK,CAAC,OAAO,CAAC,CAAC;QAHC,SAAI,GAAJ,IAAI,CAAQ;QACZ,YAAO,GAAP,OAAO,CAAe;QAGtC,IAAI,CAAC,IAAI,GAAG,iBAAiB,CAAC;QAC9B,MAAM,CAAC,cAAc,CAAC,IAAI,EAAE,GAAG,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC;IACpD,CAAC;CACF;AAZD,0CAYC;AAED;;GAEG;AACH,MAAa,kBAAmB,SAAQ,eAAe;IAC5B,IAAI,GAAG,oBAAoB,CAAC;IAErD,YAAY,OAAe,EAAE,OAAsB;QACjD,KAAK,CAAC,OAAO,EAAE,iBAAS,CAAC,mBAAmB,EAAE,OAAO,CAAC,CAAC;IACzD,CAAC;CACF;AAND,gDAMC;AAED;;GAEG;AACH,MAAa,mBAAoB,SAAQ,eAAe;IAC7B,IAAI,GAAG,qBAAqB,CAAC;IAEtD,YAAY,OAAe,EAAE,OAAsB;QACjD,KAAK,CAAC,OAAO,EAAE,iBAAS,CAAC,oBAAoB,EAAE,OAAO,CAAC,CAAC;IAC1D,CAAC;CACF;AAND,kDAMC;AAED;;GAEG;AACH,MAAa,SAAU,SAAQ,eAAe;IAK1B;IACA;IALO,IAAI,GAAG,WAAW,CAAC;IAE5C,YACE,OAAe,EACC,MAAe,EACf,UAAmB,EACnC,QAAuB;QAEvB,KAAK,CAAC,OAAO,EAAE,iBAAS,CAAC,UAAU,EAAE,QAAQ,CAAC,CAAC;QAJ/B,WAAM,GAAN,MAAM,CAAS;QACf,eAAU,GAAV,UAAU,CAAS;IAIrC,CAAC;CACF;AAXD,8BAWC;AAED;;GAEG;AACH,MAAa,eAAgB,SAAQ,eAAe;IACzB,IAAI,GAAG,iBAAiB,CAAC;IAElD,YAAY,OAAe,EAAE,OAAsB;QACjD,KAAK,CAAC,OAAO,EAAE,iBAAS,CAAC,gBAAgB,EAAE,OAAO,CAAC,CAAC;IACtD,CAAC;CACF;AAND,0CAMC;AAED;;GAEG;AACH,MAAa,YAAa,SAAQ,eAAe;IACtB,IAAI,GAAG,cAAc,CAAC;IAE/C,YAAY,OAAe,EAAE,OAAsB;QACjD,KAAK,CAAC,OAAO,EAAE,iBAAS,CAAC,aAAa,EAAE,OAAO,CAAC,CAAC;IACnD,CAAC;CACF;AAND,oCAMC"}

package/dist/index.d.ts

@@ -0,0 +1,9 @@
+export { RestClient } from "./RestClient";
+export { defineOperation, validateParams } from "./Operation";
+export type { OperationConfig } from "./Operation";
+export { AuthenticationManager } from "./AuthenticationManager";
+export { HttpClient } from "./HttpClient";
+export { RestClientError, ConfigurationError, AuthenticationError, HttpError, ValidationError, NetworkError, ErrorCode, } from "./errors";
+export type { ErrorContext, ErrorCodeType } from "./errors";
+export type { RestClientConfig, AuthConfig, OAuth2Auth, BearerAuth, TokenGeneratorAuth, NoAuth, RetryConfig, RestClientLogger, HttpMethod, } from "./types";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAC1C,OAAO,EAAE,eAAe,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAC9D,YAAY,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AACnD,OAAO,EAAE,qBAAqB,EAAE,MAAM,yBAAyB,CAAC;AAChE,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAE1C,OAAO,EACL,eAAe,EACf,kBAAkB,EAClB,mBAAmB,EACnB,SAAS,EACT,eAAe,EACf,YAAY,EACZ,SAAS,GACV,MAAM,UAAU,CAAC;AAClB,YAAY,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AAE5D,YAAY,EACV,gBAAgB,EAChB,UAAU,EACV,UAAU,EACV,UAAU,EACV,kBAAkB,EAClB,MAAM,EACN,WAAW,EACX,gBAAgB,EAChB,UAAU,GACX,MAAM,SAAS,CAAC"}

package/dist/index.js

@@ -0,0 +1,21 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ErrorCode = exports.NetworkError = exports.ValidationError = exports.HttpError = exports.AuthenticationError = exports.ConfigurationError = exports.RestClientError = exports.HttpClient = exports.AuthenticationManager = exports.validateParams = exports.defineOperation = exports.RestClient = void 0;
+var RestClient_1 = require("./RestClient");
+Object.defineProperty(exports, "RestClient", { enumerable: true, get: function () { return RestClient_1.RestClient; } });
+var Operation_1 = require("./Operation");
+Object.defineProperty(exports, "defineOperation", { enumerable: true, get: function () { return Operation_1.defineOperation; } });
+Object.defineProperty(exports, "validateParams", { enumerable: true, get: function () { return Operation_1.validateParams; } });
+var AuthenticationManager_1 = require("./AuthenticationManager");
+Object.defineProperty(exports, "AuthenticationManager", { enumerable: true, get: function () { return AuthenticationManager_1.AuthenticationManager; } });
+var HttpClient_1 = require("./HttpClient");
+Object.defineProperty(exports, "HttpClient", { enumerable: true, get: function () { return HttpClient_1.HttpClient; } });
+var errors_1 = require("./errors");
+Object.defineProperty(exports, "RestClientError", { enumerable: true, get: function () { return errors_1.RestClientError; } });
+Object.defineProperty(exports, "ConfigurationError", { enumerable: true, get: function () { return errors_1.ConfigurationError; } });
+Object.defineProperty(exports, "AuthenticationError", { enumerable: true, get: function () { return errors_1.AuthenticationError; } });
+Object.defineProperty(exports, "HttpError", { enumerable: true, get: function () { return errors_1.HttpError; } });
+Object.defineProperty(exports, "ValidationError", { enumerable: true, get: function () { return errors_1.ValidationError; } });
+Object.defineProperty(exports, "NetworkError", { enumerable: true, get: function () { return errors_1.NetworkError; } });
+Object.defineProperty(exports, "ErrorCode", { enumerable: true, get: function () { return errors_1.ErrorCode; } });
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";;;AAAA,2CAA0C;AAAjC,wGAAA,UAAU,OAAA;AACnB,yCAA8D;AAArD,4GAAA,eAAe,OAAA;AAAE,2GAAA,cAAc,OAAA;AAExC,iEAAgE;AAAvD,8HAAA,qBAAqB,OAAA;AAC9B,2CAA0C;AAAjC,wGAAA,UAAU,OAAA;AAEnB,mCAQkB;AAPhB,yGAAA,eAAe,OAAA;AACf,4GAAA,kBAAkB,OAAA;AAClB,6GAAA,mBAAmB,OAAA;AACnB,mGAAA,SAAS,OAAA;AACT,yGAAA,eAAe,OAAA;AACf,sGAAA,YAAY,OAAA;AACZ,mGAAA,SAAS,OAAA"}

package/dist/types.d.ts

@@ -0,0 +1,57 @@
+/** OAuth2 client credentials or password grant. */
+export interface OAuth2Auth {
+    readonly type: "oauth2";
+    readonly tokenUrl: string;
+    readonly clientId: string;
+    readonly clientSecret?: string;
+    readonly audience?: string;
+    readonly scope?: string;
+    readonly grantType?: "client_credentials" | "password";
+    readonly username?: string;
+    readonly password?: string;
+}
+/** Static bearer token. */
+export interface BearerAuth {
+    readonly type: "bearer";
+    readonly token: string;
+}
+/** Async token generator with optional cache duration. */
+export interface TokenGeneratorAuth {
+    readonly type: "generator";
+    readonly generate: () => Promise<string>;
+    readonly cacheDurationMs?: number;
+}
+/** No authentication. */
+export interface NoAuth {
+    readonly type: "none";
+}
+export type AuthConfig = OAuth2Auth | BearerAuth | TokenGeneratorAuth | NoAuth;
+export interface RetryConfig {
+    /** Number of retries after the initial attempt. */
+    readonly maxAttempts: number;
+    /** Delay between retries in milliseconds. */
+    readonly delayMs: number;
+    /** Additional HTTP status codes to retry on (5xx and network errors are always retried). */
+    readonly retryableStatuses?: readonly number[];
+    /** Custom retryable check. Called with the status code and parsed response body. */
+    readonly isRetryable?: (status: number, body: Record<string, unknown>) => boolean;
+}
+/**
+ * Minimal logger interface. Structurally compatible with `@hardlydifficult/logger`'s Logger class.
+ * All methods are optional -- only implement what you need.
+ */
+export interface RestClientLogger {
+    debug?(message: string, context?: Record<string, unknown>): void;
+    info?(message: string, context?: Record<string, unknown>): void;
+    warn?(message: string, context?: Record<string, unknown>): void;
+    error?(message: string, context?: Record<string, unknown>): void;
+}
+export interface RestClientConfig {
+    readonly baseUrl: string;
+    readonly auth?: AuthConfig;
+    readonly retry?: RetryConfig;
+    readonly defaultHeaders?: Readonly<Record<string, string>>;
+    readonly logger?: RestClientLogger;
+}
+export type HttpMethod = "GET" | "POST" | "DELETE" | "PATCH" | "PUT";
+//# 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":"AAAA,mDAAmD;AACnD,MAAM,WAAW,UAAU;IACzB,QAAQ,CAAC,IAAI,EAAE,QAAQ,CAAC;IACxB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,YAAY,CAAC,EAAE,MAAM,CAAC;IAC/B,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,SAAS,CAAC,EAAE,oBAAoB,GAAG,UAAU,CAAC;IACvD,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;CAC5B;AAED,2BAA2B;AAC3B,MAAM,WAAW,UAAU;IACzB,QAAQ,CAAC,IAAI,EAAE,QAAQ,CAAC;IACxB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;CACxB;AAED,0DAA0D;AAC1D,MAAM,WAAW,kBAAkB;IACjC,QAAQ,CAAC,IAAI,EAAE,WAAW,CAAC;IAC3B,QAAQ,CAAC,QAAQ,EAAE,MAAM,OAAO,CAAC,MAAM,CAAC,CAAC;IACzC,QAAQ,CAAC,eAAe,CAAC,EAAE,MAAM,CAAC;CACnC;AAED,yBAAyB;AACzB,MAAM,WAAW,MAAM;IACrB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;CACvB;AAED,MAAM,MAAM,UAAU,GAAG,UAAU,GAAG,UAAU,GAAG,kBAAkB,GAAG,MAAM,CAAC;AAE/E,MAAM,WAAW,WAAW;IAC1B,mDAAmD;IACnD,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,6CAA6C;IAC7C,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,4FAA4F;IAC5F,QAAQ,CAAC,iBAAiB,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IAC/C,oFAAoF;IACpF,QAAQ,CAAC,WAAW,CAAC,EAAE,CACrB,MAAM,EAAE,MAAM,EACd,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAC1B,OAAO,CAAC;CACd;AAED;;;GAGG;AACH,MAAM,WAAW,gBAAgB;IAC/B,KAAK,CAAC,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAC;IACjE,IAAI,CAAC,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAC;IAChE,IAAI,CAAC,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAC;IAChE,KAAK,CAAC,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAC;CAClE;AAED,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,IAAI,CAAC,EAAE,UAAU,CAAC;IAC3B,QAAQ,CAAC,KAAK,CAAC,EAAE,WAAW,CAAC;IAC7B,QAAQ,CAAC,cAAc,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;IAC3D,QAAQ,CAAC,MAAM,CAAC,EAAE,gBAAgB,CAAC;CACpC;AAED,MAAM,MAAM,UAAU,GAAG,KAAK,GAAG,MAAM,GAAG,QAAQ,GAAG,OAAO,GAAG,KAAK,CAAC"}

package/dist/types.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

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

package/package.json

@@ -0,0 +1,32 @@
+{
+  "name": "@hardlydifficult/rest-client",
+  "version": "1.0.0",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "files": [
+    "dist"
+  ],
+  "scripts": {
+    "build": "tsc",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "test:coverage": "vitest run --coverage",
+    "lint": "tsc --noEmit",
+    "clean": "rm -rf dist"
+  },
+  "dependencies": {
+    "axios": "1.9.0"
+  },
+  "peerDependencies": {
+    "zod": ">=3.0.0"
+  },
+  "devDependencies": {
+    "@types/node": "25.2.3",
+    "typescript": "5.9.3",
+    "vitest": "4.0.18",
+    "zod": "3.25.67"
+  },
+  "engines": {
+    "node": ">=18.0.0"
+  }
+}