@hardlydifficult/rest-client 1.0.54 → 1.0.56

package/README.md

@@ -1,6 +1,6 @@
 # @hardlydifficult/rest-client
 
-A typed REST client library with declarative operation definitions, OAuth2/bearer/custom token authentication, automatic retry logic, Zod-based param validation, and structured error handling.
+Opinionated REST client helpers for APIs that should feel small and obvious at the call site.
 
 ## Installation
 
@@ -8,354 +8,114 @@ A typed REST client library with declarative operation definitions, OAuth2/beare
 npm install @hardlydifficult/rest-client
 ```
 
-## Quick Start
+## Preferred API
 
 ```typescript
-import { RestClient, defineOperation } from "@hardlydifficult/rest-client";
+import { createRestClient, operation } from "@hardlydifficult/rest-client";
 import { z } from "zod";
 
-// Define a REST operation
-const GetUser = defineOperation<{ id: string }, User>({
-  params: z.object({ id: z.string() }),
-  method: "GET",
-  url: (p, base) => `${base}/users/${p.id}`,
-});
-
-// Create a client with OAuth2 auth
-class MyApi extends RestClient {
-  getUser = this.bind(GetUser);
+interface User {
+  id: string;
+  name: string;
 }
 
-const api = new MyApi({
-  baseUrl: "https://api.example.com",
-  auth: {
-    type: "oauth2",
-    tokenUrl: "https://auth.example.com/token",
-    clientId: "client-id",
-    clientSecret: "secret",
+const api = createRestClient(
+  {
+    baseUrl: "https://api.example.com/v1",
+    auth: {
+      type: "oauth2",
+      tokenUrl: "https://auth.example.com/oauth/token",
+      clientId: "client-id",
+      clientSecret: "secret",
+    },
   },
-});
+  {
+    getUser: operation.get<User>({
+      params: z.object({ id: z.string() }),
+      path: ({ id }) => `/users/${id}`,
+    }),
+    listUsers: operation.get<User[]>({
+      path: "/users",
+    }),
+    createUser: operation.post<User>({
+      params: z.object({ name: z.string().min(1) }),
+      path: "/users",
+      body: ({ name }) => ({ name }),
+    }),
+  }
+);
 
-// Make a request
 const user = await api.getUser({ id: "123" });
-// => User object with id, name, etc.
-```
-
-## Core Classes
-
-### RestClient
-
-Opinionated REST client with OAuth2, retries, and declarative operations.
-
-#### Constructor
-
-```typescript
-new RestClient(config: RestClientConfig)
+const users = await api.listUsers();
+await api.createUser({ name: "Alice" });
 ```
 
-| Property | Type | Description |
-|----------|------|-------------|
-| `baseUrl` | `string` | Base URL for all requests (required) |
-| `auth` | `AuthConfig?` | Authentication configuration (optional, default: `{ type: "none" }`) |
-| `retry` | `RetryConfig?` | Retry settings (optional, default: `{ maxAttempts: 3, delayMs: 6000 }`) |
-| `defaultHeaders` | `Record<string, string>?` | Default HTTP headers (optional) |
-| `logger` | `RestClientLogger?` | Logger instance (optional) |
-
-#### Methods
+What this gives you:
 
-```typescript
-bind<Params, Response>(
-  config: OperationConfig<Params, Response>
-): (params: Params) => Promise<Response>
-```
-
-Bind a declarative operation to the client.
+- No subclass ceremony just to bind a few endpoints.
+- Relative `path` values resolve against `baseUrl`.
+- Zero-input operations are zero-arg functions.
+- `body` derives request payloads from validated params.
 
-```typescript
-await authenticate(): Promise<string>
-```
+## Parsing Responses
 
-Authenticate and set the bearer token.
+Use `parse` when the server shape is not the shape you want in client code.
 
 ```typescript
-clearToken(): void
-```
-
-Clear the cached token, forcing re-authentication on next request.
-
-```typescript
-getBaseUrl(): string
-```
-
-Get the base URL.
-
-```typescript
-getLogger(): RestClientLogger | undefined
-```
-
-Get the logger instance.
-
-```typescript
-await get<T>(url: string): Promise<T>
-```
-
-Perform a GET request.
-
-```typescript
-await post<T>(url: string, data?: unknown): Promise<T>
-```
-
-Perform a POST request.
-
-```typescript
-await delete<T>(url: string): Promise<T>
-```
-
-Perform a DELETE request.
-
-```typescript
-await patch<T>(url: string, data?: unknown): Promise<T>
-```
-
-Perform a PATCH request.
-
-```typescript
-await put<T>(url: string, data?: unknown): Promise<T>
-```
-
-Perform a PUT request.
-
-```typescript
-getTokenExpiryTime(): number | null
-```
-
-Token expiry timestamp (ms since epoch), or `null` if unavailable.
-
-```typescript
-getTokenIssuedAt(): number | null
-```
-
-Token issue timestamp (ms since epoch), or `null` if unavailable.
-
-```typescript
-getTokenLifetimeMs(): number | null
-```
-
-Token lifetime in milliseconds, or `null` if unavailable.
-
-### HttpClient
-
-HTTP client with automatic retries and structured error formatting.
-
-#### Constructor
-
-```typescript
-new HttpClient(options?: {
-  logger?: RestClientLogger;
-  retry?: RetryConfig;
-  defaultHeaders?: Record<string, string>;
-})
-```
-
-#### Methods
-
-```typescript
-setBearerToken(token: string): void
-```
-
-Set the Authorization header with Bearer token.
-
-```typescript
-clearBearerToken(): void
-```
-
-Clear the Authorization header.
-
-```typescript
-await get<T>(url: string): Promise<T>
-```
-
-Perform a GET request.
-
-```typescript
-await post<T>(url: string, data?: unknown): Promise<T>
-```
-
-Perform a POST request.
-
-```typescript
-await delete<T>(url: string): Promise<T>
-```
-
-Perform a DELETE request.
-
-```typescript
-await patch<T>(url: string, data?: unknown): Promise<T>
-```
-
-Perform a PATCH request.
-
-```typescript
-await put<T>(url: string, data?: unknown): Promise<T>
-```
-
-Perform a PUT request.
-
-#### Retry Behavior
-
-- Automatically retries on 5xx errors and network failures
-- Default: 3 attempts with 6000ms delay between retries
-- Custom retryable status codes or conditions可通过 `retryableStatuses` and `isRetryable`
-
-### AuthenticationManager
-
-Manages token lifecycle for all supported auth strategies.
-
-#### Constructor
+const api = createRestClient(
+  { baseUrl: "https://api.example.com" },
+  {
+    searchUserNames: operation.get<
+      string[],
+      { q: string },
+      { items: Array<{ name: string }> }
+    >({
+      params: z.object({ q: z.string().min(1) }),
+      path: ({ q }) => `/users/search?q=${encodeURIComponent(q)}`,
+      parse: (response) => response.items.map((user) => user.name),
+    }),
+  }
+);
 
-```typescript
-new AuthenticationManager(config: AuthConfig, logger?: RestClientLogger)
+const names = await api.searchUserNames({ q: "ali" });
 ```
 
-#### Methods
+## Direct Requests
 
-```typescript
-await authenticate(): Promise<string>
-```
-
-Authenticate and return the bearer token.
+Direct HTTP helpers also accept relative paths.
 
 ```typescript
-clearToken(): void
-```
-
-Clear cached token and timing info.
+const api = createRestClient({ baseUrl: "https://api.example.com/v1" }, {});
 
-```typescript
-getTokenExpiryTime(): number | null
+const health = await api.get<{ ok: boolean }>("/health");
+await api.post("/users", { name: "Alice" });
 ```
 
-Token expiry timestamp (ms since epoch), or `null` if unavailable.
+## Advanced Usage
 
-```typescript
-getTokenIssuedAt(): number | null
-```
-
-Token issue timestamp (ms since epoch), or `null` if unavailable.
+`RestClient` is still available if you want a class-based wrapper:
 
 ```typescript
-getTokenLifetimeMs(): number | null
-```
-
-Token lifetime in milliseconds, or `null` if unavailable.
-
-#### Supported Auth Types
-
-| Type | Config | Description |
-|------|--------|-------------|
-| `bearer` | `{ type: "bearer", token: string }` | Static bearer token |
-| `generator` | `{ type: "generator", generate: () => Promise<string>, cacheDurationMs?: number }` | Async token generator with optional cache |
-| `oauth2` | `{ type: "oauth2", tokenUrl: string, clientId: string, clientSecret?: string, audience?: string, scope?: string, grantType?: "client_credentials" \| "password", username?: string, password?: string }` | OAuth2 client credentials or password grant |
-| `none` | `{ type: "none" }` | No authentication (default) |
-
-### defineOperation
-
-Define a REST operation declaratively.
+import { operation, RestClient } from "@hardlydifficult/rest-client";
+import { z } from "zod";
 
-```typescript
-const GetUser = defineOperation<{ id: string }, User>({
+const GetUser = operation.get<User>({
   params: z.object({ id: z.string() }),
-  method: "GET",
-  url: (p, base) => `${base}/users/${p.id}`,
+  path: ({ id }) => `/users/${id}`,
 });
-```
-
-#### Config Fields
-
-| Field | Type | Required | Description |
-|-------|------|----------|-------------|
-| `params` | `z.ZodType<Params>` | Yes | Zod schema for request parameters |
-| `method` | `HttpMethod` | Yes | HTTP method: `"GET"`, `"POST"`, `"DELETE"`, `"PATCH"`, `"PUT"` |
-| `url` | `(params: Params, baseUrl: string) => string` | Yes | URL builder function |
-| `body` | `(params: Params) => Record<string, unknown> \| string \| undefined` | No | Optional body builder |
-| `transform` | `(response: Response) => Response` | No | Optional response transformer |
-
-### validateParams
-
-Validate params against a Zod schema, throwing `ValidationError` on failure.
-
-```typescript
-validateParams<T>(params: T, schema: z.ZodType<T>): T
-```
-
-```typescript
-const validated = validateParams({ id: "123" }, z.object({ id: z.string() }));
-// => { id: "123" }
-```
-
-## Error Handling
-
-All errors extend `RestClientError` and include a `code` and optional `context`.
 
-| Error Type | Code | Description |
-|------------|------|-------------|
-| `ConfigurationError` | `"CONFIGURATION_ERROR"` | Invalid client configuration (e.g., missing `baseUrl`) |
-| `AuthenticationError` | `"AUTHENTICATION_ERROR"` | Authentication failure |
-| `HttpError` | `"HTTP_ERROR"` | HTTP error with status, statusText, and response data |
-| `ValidationError` | `"VALIDATION_ERROR"` | Parameter validation failure (via Zod) |
-| `NetworkError` | `"NETWORK_ERROR"` | Network-level errors (e.g., DNS failure, connection refused) |
-
-Example:
-
-```typescript
-try {
-  await api.getUser({ id: "123" });
-} catch (error) {
-  if (error instanceof HttpError) {
-    console.log(error.status, error.message);
-  }
-}
-```
-
-## Types
-
-### AuthConfig
-
-Union type of auth configurations: `OAuth2Auth | BearerAuth | TokenGeneratorAuth | NoAuth`
-
-### RetryConfig
-
-| Property | Type | Default | Description |
-|----------|------|---------|-------------|
-| `maxAttempts` | `number` | `3` | Number of retries after the initial attempt |
-| `delayMs` | `number` | `6000` | Delay between retries in milliseconds |
-| `retryableStatuses` | `readonly number[]?` | `undefined` | Additional HTTP status codes to retry on |
-| `isRetryable` | `(status: number, body: Record<string, unknown>) => boolean?` | `undefined` | Custom retryable check |
-
-### RestClientLogger
-
-Minimal logger interface (compatible with `@hardlydifficult/logger`):
-
-```typescript
-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;
+class MyApi extends RestClient {
+  getUser = this.bind(GetUser);
 }
 ```
 
-All methods are optional — only implement what you need.
-
-## Appendix
-
-### Retryable Status Codes
+## Authentication
 
-By default, the client retries on:
+Supported auth config types:
 
-- All 5xx status codes (500–599)
-- Network errors (no response)
-- Custom status codes via `retryableStatuses`
-- Custom conditions via `isRetryable`
+- `none`
+- `bearer`
+- `generator`
+- `oauth2`
 
-OAuth2 token refresh is automatically triggered when the token is near expiry (half its lifetime or 5 minutes, whichever is smaller).
+`createRestClient` and `RestClient` share the same auth, retry, logging, and error behavior.

package/dist/Operation.d.ts

@@ -1,13 +1,17 @@
 import { z } from "zod";
 import type { HttpMethod } from "./types.js";
 /** Declarative configuration for a REST operation. */
-export interface OperationConfig<Params, Response> {
-    readonly params: z.ZodType<Params>;
+export interface OperationConfig<Params = undefined, Response = unknown, RawResponse = Response> {
+    readonly params?: z.ZodType<Params>;
     readonly method: HttpMethod;
-    readonly url: (params: Params, baseUrl: string) => string;
+    readonly path?: string | ((params: Params) => string);
+    readonly url?: (params: Params, baseUrl: string) => string;
     readonly body?: (params: Params) => Record<string, unknown> | string | undefined;
-    readonly transform?: (response: Response) => Response;
+    readonly parse?: (response: RawResponse, params: Params) => Response;
+    readonly transform?: (response: RawResponse, params: Params) => Response;
 }
+export type OperationOptions<Params = undefined, Response = unknown, RawResponse = Response> = Omit<OperationConfig<Params, Response, RawResponse>, "method">;
+export type BoundOperation<Params, Response> = [Params] extends [undefined] ? () => Promise<Response> : (params: Params) => Promise<Response>;
 /**
  * Define a REST operation declaratively.
  *
@@ -18,7 +22,14 @@ export interface OperationConfig<Params, Response> {
  *     url: (p, base) => `${base}/users/${p.id}`,
  *   });
  */
-export declare function defineOperation<Params, Response>(config: OperationConfig<Params, Response>): OperationConfig<Params, Response>;
+export declare function defineOperation<Params = undefined, Response = unknown, RawResponse = Response>(config: OperationConfig<Params, Response, RawResponse>): OperationConfig<Params, Response, RawResponse>;
 /** Validate params against a Zod schema, throwing ValidationError on failure. */
 export declare function validateParams<T>(params: T, schema: z.ZodType<T>): T;
+export declare const operation: {
+    readonly get: <Response, Params = undefined, RawResponse = Response>(config: OperationOptions<Params, Response, RawResponse>) => OperationConfig<Params, Response, RawResponse>;
+    readonly post: <Response, Params = undefined, RawResponse = Response>(config: OperationOptions<Params, Response, RawResponse>) => OperationConfig<Params, Response, RawResponse>;
+    readonly delete: <Response, Params = undefined, RawResponse = Response>(config: OperationOptions<Params, Response, RawResponse>) => OperationConfig<Params, Response, RawResponse>;
+    readonly patch: <Response, Params = undefined, RawResponse = Response>(config: OperationOptions<Params, Response, RawResponse>) => OperationConfig<Params, Response, RawResponse>;
+    readonly put: <Response, Params = undefined, RawResponse = Response>(config: OperationOptions<Params, Response, RawResponse>) => OperationConfig<Params, Response, RawResponse>;
+};
 //# sourceMappingURL=Operation.d.ts.map

package/dist/Operation.d.ts.map

@@ -1 +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,YAAY,CAAC;AAE7C,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"}
+{"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,YAAY,CAAC;AAE7C,sDAAsD;AACtD,MAAM,WAAW,eAAe,CAC9B,MAAM,GAAG,SAAS,EAClB,QAAQ,GAAG,OAAO,EAClB,WAAW,GAAG,QAAQ;IAEtB,QAAQ,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC;IACpC,QAAQ,CAAC,MAAM,EAAE,UAAU,CAAC;IAC5B,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,GAAG,CAAC,CAAC,MAAM,EAAE,MAAM,KAAK,MAAM,CAAC,CAAC;IACtD,QAAQ,CAAC,GAAG,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,KAAK,MAAM,CAAC;IAC3D,QAAQ,CAAC,IAAI,CAAC,EAAE,CACd,MAAM,EAAE,MAAM,KACX,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM,GAAG,SAAS,CAAC;IAClD,QAAQ,CAAC,KAAK,CAAC,EAAE,CAAC,QAAQ,EAAE,WAAW,EAAE,MAAM,EAAE,MAAM,KAAK,QAAQ,CAAC;IACrE,QAAQ,CAAC,SAAS,CAAC,EAAE,CAAC,QAAQ,EAAE,WAAW,EAAE,MAAM,EAAE,MAAM,KAAK,QAAQ,CAAC;CAC1E;AAED,MAAM,MAAM,gBAAgB,CAC1B,MAAM,GAAG,SAAS,EAClB,QAAQ,GAAG,OAAO,EAClB,WAAW,GAAG,QAAQ,IACpB,IAAI,CAAC,eAAe,CAAC,MAAM,EAAE,QAAQ,EAAE,WAAW,CAAC,EAAE,QAAQ,CAAC,CAAC;AAEnE,MAAM,MAAM,cAAc,CAAC,MAAM,EAAE,QAAQ,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,SAAS,CAAC,GACvE,MAAM,OAAO,CAAC,QAAQ,CAAC,GACvB,CAAC,MAAM,EAAE,MAAM,KAAK,OAAO,CAAC,QAAQ,CAAC,CAAC;AAE1C;;;;;;;;;GASG;AACH,wBAAgB,eAAe,CAC7B,MAAM,GAAG,SAAS,EAClB,QAAQ,GAAG,OAAO,EAClB,WAAW,GAAG,QAAQ,EAEtB,MAAM,EAAE,eAAe,CAAC,MAAM,EAAE,QAAQ,EAAE,WAAW,CAAC,GACrD,eAAe,CAAC,MAAM,EAAE,QAAQ,EAAE,WAAW,CAAC,CAKhD;AAED,iFAAiF;AACjF,wBAAgB,cAAc,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,GAAG,CAAC,CAWpE;AAaD,eAAO,MAAM,SAAS;mBAChB,QAAQ,EAAE,MAAM,cAAc,WAAW,qBACnC,gBAAgB,CAAC,MAAM,EAAE,QAAQ,EAAE,WAAW,CAAC,KACtD,eAAe,CAAC,MAAM,EAAE,QAAQ,EAAE,WAAW,CAAC;oBAG5C,QAAQ,EAAE,MAAM,cAAc,WAAW,qBACpC,gBAAgB,CAAC,MAAM,EAAE,QAAQ,EAAE,WAAW,CAAC,KACtD,eAAe,CAAC,MAAM,EAAE,QAAQ,EAAE,WAAW,CAAC;sBAG1C,QAAQ,EAAE,MAAM,cAAc,WAAW,qBACtC,gBAAgB,CAAC,MAAM,EAAE,QAAQ,EAAE,WAAW,CAAC,KACtD,eAAe,CAAC,MAAM,EAAE,QAAQ,EAAE,WAAW,CAAC;qBAG3C,QAAQ,EAAE,MAAM,cAAc,WAAW,qBACrC,gBAAgB,CAAC,MAAM,EAAE,QAAQ,EAAE,WAAW,CAAC,KACtD,eAAe,CAAC,MAAM,EAAE,QAAQ,EAAE,WAAW,CAAC;mBAG7C,QAAQ,EAAE,MAAM,cAAc,WAAW,qBACnC,gBAAgB,CAAC,MAAM,EAAE,QAAQ,EAAE,WAAW,CAAC,KACtD,eAAe,CAAC,MAAM,EAAE,QAAQ,EAAE,WAAW,CAAC;CAGzC,CAAC"}

package/dist/Operation.js

@@ -1,5 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
+exports.operation = void 0;
 exports.defineOperation = defineOperation;
 exports.validateParams = validateParams;
 const zod_1 = require("zod");
@@ -15,6 +16,9 @@ const errors_js_1 = require("./errors.js");
  *   });
  */
 function defineOperation(config) {
+    if (config.path === undefined && config.url === undefined) {
+        throw new errors_js_1.ConfigurationError("Operation requires either path or url");
+    }
     return config;
 }
 /** Validate params against a Zod schema, throwing ValidationError on failure. */
@@ -29,4 +33,24 @@ function validateParams(params, schema) {
         throw error;
     }
 }
+function defineMethodOperation(method, config) {
+    return defineOperation({ ...config, method });
+}
+exports.operation = {
+    get(config) {
+        return defineMethodOperation("GET", config);
+    },
+    post(config) {
+        return defineMethodOperation("POST", config);
+    },
+    delete(config) {
+        return defineMethodOperation("DELETE", config);
+    },
+    patch(config) {
+        return defineMethodOperation("PATCH", config);
+    },
+    put(config) {
+        return defineMethodOperation("PUT", config);
+    },
+};
 //# sourceMappingURL=Operation.js.map

package/dist/Operation.js.map

@@ -1 +1 @@
-{"version":3,"file":"Operation.js","sourceRoot":"","sources":["../src/Operation.ts"],"names":[],"mappings":";;AA0BA,0CAIC;AAGD,wCAWC;AA5CD,6BAAwB;AAExB,2CAA8C;AAc9C;;;;;;;;;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,2BAAe,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"}
+{"version":3,"file":"Operation.js","sourceRoot":"","sources":["../src/Operation.ts"],"names":[],"mappings":";;;AA0CA,0CAWC;AAGD,wCAWC;AAnED,6BAAwB;AAExB,2CAAkE;AA8BlE;;;;;;;;;GASG;AACH,SAAgB,eAAe,CAK7B,MAAsD;IAEtD,IAAI,MAAM,CAAC,IAAI,KAAK,SAAS,IAAI,MAAM,CAAC,GAAG,KAAK,SAAS,EAAE,CAAC;QAC1D,MAAM,IAAI,8BAAkB,CAAC,uCAAuC,CAAC,CAAC;IACxE,CAAC;IACD,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,2BAAe,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;AAED,SAAS,qBAAqB,CAK5B,MAAkB,EAClB,MAAuD;IAEvD,OAAO,eAAe,CAAC,EAAE,GAAG,MAAM,EAAE,MAAM,EAAE,CAAC,CAAC;AAChD,CAAC;AAEY,QAAA,SAAS,GAAG;IACvB,GAAG,CACD,MAAuD;QAEvD,OAAO,qBAAqB,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC;IAC9C,CAAC;IACD,IAAI,CACF,MAAuD;QAEvD,OAAO,qBAAqB,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC/C,CAAC;IACD,MAAM,CACJ,MAAuD;QAEvD,OAAO,qBAAqB,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAC;IACjD,CAAC;IACD,KAAK,CACH,MAAuD;QAEvD,OAAO,qBAAqB,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC;IAChD,CAAC;IACD,GAAG,CACD,MAAuD;QAEvD,OAAO,qBAAqB,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC;IAC9C,CAAC;CACO,CAAC"}

package/dist/RestClient.d.ts

@@ -1,5 +1,11 @@
-import { type OperationConfig } from "./Operation.js";
+import { type BoundOperation, type OperationConfig } from "./Operation.js";
 import type { RestClientConfig, RestClientLogger } from "./types.js";
+export type AnyOperationConfig = OperationConfig<unknown, unknown, unknown>;
+export type OperationMap = Record<string, AnyOperationConfig>;
+export type BoundOperations<TOperations extends OperationMap> = {
+    [Name in keyof TOperations]: TOperations[Name] extends OperationConfig<infer Params, infer Response, infer _RawResponse> ? BoundOperation<Params, Response> : never;
+};
+export type RestClientApi<TOperations extends OperationMap> = RestClient & BoundOperations<TOperations>;
 /**
  * Opinionated REST client with OAuth2, retries, and declarative operations.
  *
@@ -33,7 +39,7 @@ export declare class RestClient {
      *     getUser = this.bind(GetUser);
      *   }
      */
-    bind<Params, Response>(config: OperationConfig<Params, Response>): (params: Params) => Promise<Response>;
+    bind<Params = undefined, Response = unknown, RawResponse = Response>(config: OperationConfig<Params, Response, RawResponse>): BoundOperation<Params, Response>;
     /** Authenticate and set the bearer token for subsequent requests. */
     authenticate(): Promise<string>;
     /** Clear the cached token, forcing re-authentication on next request. */
@@ -50,5 +56,8 @@ export declare class RestClient {
     patch<T>(url: string, data?: unknown): Promise<T>;
     put<T>(url: string, data?: unknown): Promise<T>;
     private executeMethod;
+    private resolveUrl;
 }
+/** Create a RestClient instance with operation configs bound as typed methods. */
+export declare function createRestClient<TOperations extends OperationMap>(config: RestClientConfig, operations: TOperations): RestClientApi<TOperations>;
 //# sourceMappingURL=RestClient.d.ts.map

package/dist/RestClient.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"RestClient.d.ts","sourceRoot":"","sources":["../src/RestClient.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,KAAK,eAAe,EAAkB,MAAM,gBAAgB,CAAC;AACtE,OAAO,KAAK,EAEV,gBAAgB,EAChB,gBAAgB,EACjB,MAAM,YAAY,CAAC;AAEpB;;;;;;;;;;;;;;;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"}
+{"version":3,"file":"RestClient.d.ts","sourceRoot":"","sources":["../src/RestClient.ts"],"names":[],"mappings":"AAKA,OAAO,EACL,KAAK,cAAc,EACnB,KAAK,eAAe,EAErB,MAAM,gBAAgB,CAAC;AACxB,OAAO,KAAK,EAEV,gBAAgB,EAChB,gBAAgB,EACjB,MAAM,YAAY,CAAC;AAKpB,MAAM,MAAM,kBAAkB,GAAG,eAAe,CAAC,OAAO,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC;AAC5E,MAAM,MAAM,YAAY,GAAG,MAAM,CAAC,MAAM,EAAE,kBAAkB,CAAC,CAAC;AAE9D,MAAM,MAAM,eAAe,CAAC,WAAW,SAAS,YAAY,IAAI;KAC7D,IAAI,IAAI,MAAM,WAAW,GAAG,WAAW,CAAC,IAAI,CAAC,SAAS,eAAe,CACpE,MAAM,MAAM,EACZ,MAAM,QAAQ,EACd,MAAM,YAAY,CACnB,GACG,cAAc,CAAC,MAAM,EAAE,QAAQ,CAAC,GAChC,KAAK;CACV,CAAC;AAEF,MAAM,MAAM,aAAa,CAAC,WAAW,SAAS,YAAY,IAAI,UAAU,GACtE,eAAe,CAAC,WAAW,CAAC,CAAC;AAE/B;;;;;;;;;;;;;;;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,GAAG,SAAS,EAAE,QAAQ,GAAG,OAAO,EAAE,WAAW,GAAG,QAAQ,EACjE,MAAM,EAAE,eAAe,CAAC,MAAM,EAAE,QAAQ,EAAE,WAAW,CAAC,GACrD,cAAc,CAAC,MAAM,EAAE,QAAQ,CAAC;IAqBnC,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;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;IAIjD,GAAG,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,OAAO,GAAG,OAAO,CAAC,CAAC,CAAC;YAIvC,aAAa;IAyB3B,OAAO,CAAC,UAAU;CAGnB;AAED,kFAAkF;AAClF,wBAAgB,gBAAgB,CAAC,WAAW,SAAS,YAAY,EAC/D,MAAM,EAAE,gBAAgB,EACxB,UAAU,EAAE,WAAW,GACtB,aAAa,CAAC,WAAW,CAAC,CAsB5B"}

package/dist/RestClient.js

@@ -1,10 +1,14 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.RestClient = void 0;
+exports.createRestClient = createRestClient;
+const zod_1 = require("zod");
 const AuthenticationManager_js_1 = require("./AuthenticationManager.js");
 const errors_js_1 = require("./errors.js");
 const HttpClient_js_1 = require("./HttpClient.js");
 const Operation_js_1 = require("./Operation.js");
+const NO_PARAMS_SCHEMA = zod_1.z.void();
+const ABSOLUTE_URL_PATTERN = /^[a-zA-Z][a-zA-Z\d+.-]*:/;
 /**
  * Opinionated REST client with OAuth2, retries, and declarative operations.
  *
@@ -56,14 +60,16 @@ class RestClient {
      *   }
      */
     bind(config) {
-        return async (params) => {
-            const validated = (0, Operation_js_1.validateParams)(params, config.params);
-            const url = config.url(validated, this.getBaseUrl());
+        const bound = async (params) => {
+            const validated = (0, Operation_js_1.validateParams)(params, getParamsSchema(config.params));
+            const url = resolveOperationUrl(config, validated, this.getBaseUrl());
             const response = await this.executeMethod(config.method, url, config.body?.(validated));
-            return config.transform !== undefined
-                ? config.transform(response)
+            const parser = config.parse ?? config.transform;
+            return parser !== undefined
+                ? parser(response, validated)
                 : response;
         };
+        return bound;
     }
     /** Authenticate and set the bearer token for subsequent requests. */
     async authenticate() {
@@ -91,42 +97,85 @@ class RestClient {
         return this.authManager.getTokenLifetimeMs();
     }
     async get(url) {
-        await this.authenticate();
-        return this.httpClient.get(url);
+        return this.executeMethod("GET", url);
     }
     async post(url, data) {
-        await this.authenticate();
-        return this.httpClient.post(url, data);
+        return this.executeMethod("POST", url, data);
     }
     async delete(url) {
-        await this.authenticate();
-        return this.httpClient.delete(url);
+        return this.executeMethod("DELETE", url);
     }
     async patch(url, data) {
-        await this.authenticate();
-        return this.httpClient.patch(url, data);
+        return this.executeMethod("PATCH", url, data);
     }
     async put(url, data) {
-        await this.authenticate();
-        return this.httpClient.put(url, data);
+        return this.executeMethod("PUT", url, data);
     }
     async executeMethod(method, url, data) {
         await this.authenticate();
+        const resolvedUrl = this.resolveUrl(url);
         switch (method) {
             case "GET":
-                return this.httpClient.get(url);
+                return this.httpClient.get(resolvedUrl);
             case "POST":
-                return this.httpClient.post(url, data);
+                return this.httpClient.post(resolvedUrl, data);
             case "DELETE":
-                return this.httpClient.delete(url);
+                return this.httpClient.delete(resolvedUrl);
             case "PATCH":
-                return this.httpClient.patch(url, data);
+                return this.httpClient.patch(resolvedUrl, data);
             case "PUT":
-                return this.httpClient.put(url, data);
+                return this.httpClient.put(resolvedUrl, data);
             default:
                 throw new errors_js_1.ConfigurationError(`Unsupported HTTP method: ${method}`);
         }
     }
+    resolveUrl(url) {
+        return resolveUrl(this.getBaseUrl(), url);
+    }
 }
 exports.RestClient = RestClient;
+/** Create a RestClient instance with operation configs bound as typed methods. */
+function createRestClient(config, operations) {
+    const client = new RestClient(config);
+    for (const [name, operation] of Object.entries(operations)) {
+        if (name in client) {
+            throw new errors_js_1.ConfigurationError(`Operation name "${name}" conflicts with an existing RestClient property`);
+        }
+        Object.defineProperty(client, name, {
+            configurable: false,
+            enumerable: true,
+            value: client.bind(operation),
+            writable: false,
+        });
+    }
+    return client;
+}
+function getParamsSchema(schema) {
+    return (schema ?? NO_PARAMS_SCHEMA);
+}
+function resolveOperationUrl(config, params, baseUrl) {
+    if (config.path !== undefined) {
+        const path = typeof config.path === "function" ? config.path(params) : config.path;
+        return resolveUrl(baseUrl, path);
+    }
+    if (config.url !== undefined) {
+        return resolveUrl(baseUrl, config.url(params, baseUrl));
+    }
+    throw new errors_js_1.ConfigurationError("Operation requires either path or url");
+}
+function resolveUrl(baseUrl, urlOrPath) {
+    if (ABSOLUTE_URL_PATTERN.test(urlOrPath)) {
+        return urlOrPath;
+    }
+    try {
+        const normalizedBaseUrl = baseUrl.endsWith("/") ? baseUrl : `${baseUrl}/`;
+        const normalizedPath = urlOrPath.startsWith("/")
+            ? urlOrPath.slice(1)
+            : urlOrPath;
+        return new URL(normalizedPath, normalizedBaseUrl).toString();
+    }
+    catch {
+        throw new errors_js_1.ConfigurationError(`Invalid URL or path: ${urlOrPath} (baseUrl: ${baseUrl})`);
+    }
+}
 //# sourceMappingURL=RestClient.js.map

package/dist/RestClient.js.map

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

package/dist/index.d.ts

@@ -1,6 +1,7 @@
-export { RestClient } from "./RestClient.js";
-export { defineOperation, validateParams } from "./Operation.js";
-export type { OperationConfig } from "./Operation.js";
+export { RestClient, createRestClient } from "./RestClient.js";
+export { defineOperation, operation, validateParams } from "./Operation.js";
+export type { BoundOperation, OperationConfig, OperationOptions, } from "./Operation.js";
+export type { AnyOperationConfig, BoundOperations, OperationMap, RestClientApi, } from "./RestClient.js";
 export { AuthenticationManager } from "./AuthenticationManager.js";
 export { HttpClient } from "./HttpClient.js";
 export { RestClientError, ConfigurationError, AuthenticationError, HttpError, ValidationError, NetworkError, ErrorCode, } from "./errors.js";

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAC7C,OAAO,EAAE,eAAe,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AACjE,YAAY,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAC;AACtD,OAAO,EAAE,qBAAqB,EAAE,MAAM,4BAA4B,CAAC;AACnE,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAE7C,OAAO,EACL,eAAe,EACf,kBAAkB,EAClB,mBAAmB,EACnB,SAAS,EACT,eAAe,EACf,YAAY,EACZ,SAAS,GACV,MAAM,aAAa,CAAC;AACrB,YAAY,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAE/D,YAAY,EACV,gBAAgB,EAChB,UAAU,EACV,UAAU,EACV,UAAU,EACV,kBAAkB,EAClB,MAAM,EACN,WAAW,EACX,gBAAgB,EAChB,UAAU,GACX,MAAM,YAAY,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AAC/D,OAAO,EAAE,eAAe,EAAE,SAAS,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AAC5E,YAAY,EACV,cAAc,EACd,eAAe,EACf,gBAAgB,GACjB,MAAM,gBAAgB,CAAC;AACxB,YAAY,EACV,kBAAkB,EAClB,eAAe,EACf,YAAY,EACZ,aAAa,GACd,MAAM,iBAAiB,CAAC;AACzB,OAAO,EAAE,qBAAqB,EAAE,MAAM,4BAA4B,CAAC;AACnE,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAE7C,OAAO,EACL,eAAe,EACf,kBAAkB,EAClB,mBAAmB,EACnB,SAAS,EACT,eAAe,EACf,YAAY,EACZ,SAAS,GACV,MAAM,aAAa,CAAC;AACrB,YAAY,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAE/D,YAAY,EACV,gBAAgB,EAChB,UAAU,EACV,UAAU,EACV,UAAU,EACV,kBAAkB,EAClB,MAAM,EACN,WAAW,EACX,gBAAgB,EAChB,UAAU,GACX,MAAM,YAAY,CAAC"}

package/dist/index.js

@@ -1,10 +1,12 @@
 "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;
+exports.ErrorCode = exports.NetworkError = exports.ValidationError = exports.HttpError = exports.AuthenticationError = exports.ConfigurationError = exports.RestClientError = exports.HttpClient = exports.AuthenticationManager = exports.validateParams = exports.operation = exports.defineOperation = exports.createRestClient = exports.RestClient = void 0;
 var RestClient_js_1 = require("./RestClient.js");
 Object.defineProperty(exports, "RestClient", { enumerable: true, get: function () { return RestClient_js_1.RestClient; } });
+Object.defineProperty(exports, "createRestClient", { enumerable: true, get: function () { return RestClient_js_1.createRestClient; } });
 var Operation_js_1 = require("./Operation.js");
 Object.defineProperty(exports, "defineOperation", { enumerable: true, get: function () { return Operation_js_1.defineOperation; } });
+Object.defineProperty(exports, "operation", { enumerable: true, get: function () { return Operation_js_1.operation; } });
 Object.defineProperty(exports, "validateParams", { enumerable: true, get: function () { return Operation_js_1.validateParams; } });
 var AuthenticationManager_js_1 = require("./AuthenticationManager.js");
 Object.defineProperty(exports, "AuthenticationManager", { enumerable: true, get: function () { return AuthenticationManager_js_1.AuthenticationManager; } });

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";;;AAAA,iDAA6C;AAApC,2GAAA,UAAU,OAAA;AACnB,+CAAiE;AAAxD,+GAAA,eAAe,OAAA;AAAE,8GAAA,cAAc,OAAA;AAExC,uEAAmE;AAA1D,iIAAA,qBAAqB,OAAA;AAC9B,iDAA6C;AAApC,2GAAA,UAAU,OAAA;AAEnB,yCAQqB;AAPnB,4GAAA,eAAe,OAAA;AACf,+GAAA,kBAAkB,OAAA;AAClB,gHAAA,mBAAmB,OAAA;AACnB,sGAAA,SAAS,OAAA;AACT,4GAAA,eAAe,OAAA;AACf,yGAAA,YAAY,OAAA;AACZ,sGAAA,SAAS,OAAA"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";;;AAAA,iDAA+D;AAAtD,2GAAA,UAAU,OAAA;AAAE,iHAAA,gBAAgB,OAAA;AACrC,+CAA4E;AAAnE,+GAAA,eAAe,OAAA;AAAE,yGAAA,SAAS,OAAA;AAAE,8GAAA,cAAc,OAAA;AAYnD,uEAAmE;AAA1D,iIAAA,qBAAqB,OAAA;AAC9B,iDAA6C;AAApC,2GAAA,UAAU,OAAA;AAEnB,yCAQqB;AAPnB,4GAAA,eAAe,OAAA;AACf,+GAAA,kBAAkB,OAAA;AAClB,gHAAA,mBAAmB,OAAA;AACnB,sGAAA,SAAS,OAAA;AACT,4GAAA,eAAe,OAAA;AACf,yGAAA,YAAY,OAAA;AACZ,sGAAA,SAAS,OAAA"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@hardlydifficult/rest-client",
-  "version": "1.0.54",
+  "version": "1.0.56",
   "main": "./dist/index.js",
   "types": "./dist/index.d.ts",
   "files": [