@nxgt/datasource-rest 1.0.3 → 3.0.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Steve Tsala
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -1,87 +1,386 @@
 # @nxgt/datasource-rest
 
-An Apollo-style REST datasource over `openapi-fetch`: auth forwarding, caching
-and error translation, so a GraphQL resolver can call a REST service with the
-same typed client the REST apps use.
+A REST service, called from a GraphQL resolver or any server code, through
+the client [`@nxgt/openapi-httpyz`](https://www.npmjs.com/package/@nxgt/openapi-httpyz)
+binds to its spec. On top of that client it adds three things:
+
+- it forwards the caller's token;
+- it caches reads across the datasources of every request;
+- it throws one `DataSourceError`, with a code a GraphQL server reports,
+  whenever a call fails.
 
 ## Install
 
 ```bash
-bun add @nxgt/datasource-rest
+bun add @nxgt/datasource-rest @nxgt/httpyz @nxgt/openapi-httpyz zod
+bun add -d @nxgt/openapi-codegen typescript
 ```
 
-Public on npmjs; no token needed to install. TypeScript is a peer, pinned to
-`^6.0.3` across every `@nxgt/*` package — the set is unsatisfiable if one of
-them widens it.
+`@nxgt/httpyz` and `@nxgt/openapi-httpyz` are required peers. The generated
+`operations.ts` imports `zod`, so the app needs it too. TypeScript is a peer,
+`^6.0.3`, as in every `@nxgt/*` package. `@nxgt/openapi-codegen` generates
+the spec's files, with `nxgt-openapi generate`.
 
 ## Usage
 
+Extend the datasource with the calls your resolvers make, and make one per
+request:
+
 ```ts
-import { RESTDataSource, errorToException } from '@nxgt/datasource-rest';
-import createClient from '@nxgt/shared-hono/openapi-fetch';
+import { RESTDataSource } from '@nxgt/datasource-rest';
+import { operations } from './generated/bookmarks/operations.js';
 
-const client = createClient<paths>({ baseUrl: env.BOOKMARKS_API_URL });
+export class Bookmarks extends RESTDataSource.for(operations) {
+	bookmark(id: string) {
+		return this.data(this.get('/bookmarks/{id}', { param: { id } }));
+	}
+	search(q: string) {
+		return this.data(this.query('/bookmarks', { json: { q } }));
+	}
+}
 
-const bookmarks = new RESTDataSource({
-	client,
-	authOptions: { token: () => getAccessToken() },
-	cacheOptions: { ttl: 5_000 },
+// Per request, in the GraphQL context:
+const bookmarks = new Bookmarks({
+	baseUrl: 'https://bookmarks.example.com',
+	token: () => context.token,
 });
+```
 
-const { data } = await bookmarks.get('/bookmarks/{id}', {
-	params: { path: { id } },
-});
+- **`RESTDataSource.for(operations)`** is the class bound to the generated
+  table, whose types it takes from it. The same without it:
+  `extends RESTDataSource<ClientOperations>`, with `operations` passed to the
+  constructor.
+- **It validates and decodes by default**, as its client does: the request
+  before it is sent, and each reply as its schema outputs it.
+  `validate: false` and `decode: false` turn that off.
+- **`this.get`, `this.post`, `this.query`…** call the operation at a path,
+  typed by the spec. There is one for each method the spec has an operation
+  for, and it offers only the paths that method has. Each call resolves to
+  one of the declared replies, narrowed on its status.
+- **`this.api`** is the bound client they come from, for `op(operationId)`,
+  `stream()` and `group()`. The shorthands are set on each datasource, for
+  the spec's methods only, so a subclass's own method of the same name wins.
+- **`this.data(call)`** returns the data of a 2xx reply. Any other reply, or
+  none, throws a `DataSourceError`.
+
+Every option is in [the API](#restdatasource).
+
+## Cache
+
+`defaultCache` is one store for every datasource, since a server makes them
+per request. It is `cache()` from `@nxgt/httpyz`, with its defaults: it
+keeps the `ok` replies of the reads, `GET`, `HEAD` and `QUERY`, for five
+minutes. A search is a `QUERY`; a `POST` is never cached.
+
+Its key is the method, the URL, the `Authorization` header and the body. So
+no caller is answered with another's reply, and a search is cached by what it
+searches for. It holds at most 500 replies, the least recently used going
+first.
+
+`defaultCache.clear()` empties it, after a write, say. A cache of your own
+takes `cache()`'s options; `cache: false` turns it off:
+
+```ts
+import { cache } from '@nxgt/httpyz';
+
+const bookmarksCache = cache({ ttl: 30_000 });
+new Bookmarks({ baseUrl, operations, cache: bookmarksCache });
 ```
 
-`get` / `post` / `put` / `patch` / `delete` / `head` / `options` / `trace` are
-the client's methods, rebound. Auth and cache are `openapi-fetch` middleware
-installed in the constructor, cache first, then auth.
+## Errors
+
+`this.data` throws a `DataSourceError`, the package's own. graphql-js reports
+its `extensions`, `{ code, status }`, with the error a resolver throws.
+
+| What happened | `code` |
+| --- | --- |
+| 401 | `UNAUTHENTICATED` |
+| 403 | `FORBIDDEN` |
+| 404 | `NOT_FOUND` |
+| any 5xx | `INTERNAL_SERVER_ERROR` |
+| any other status | `BAD_REQUEST` |
+| no reply: network, timeout | `SERVICE_UNAVAILABLE` |
+| a request `validate` refuses, with its `issues` | `BAD_REQUEST` |
+| a reply `validate` or `decode` refuses, with its `issues` | `INTERNAL_SERVER_ERROR` |
+| anything else thrown | `INTERNAL_SERVER_ERROR` |
 
-## Auth middleware
+Its message is the reply body's `message`, when it has a non-empty one. For
+a call you make without `this.data`, `toDataSourceError` makes one out of
+whatever the client threw. To map it onto your app's exceptions, catch it
+where you throw yours:
 
 ```ts
-authOptions: {
-	token: string | (() => Promise<string>),
-	shouldUseToken?: (request: Request) => boolean,
+import { DataSourceError } from '@nxgt/datasource-rest';
+
+try {
+	return await bookmarks.bookmark(id);
+} catch (error) {
+	if (error instanceof DataSourceError && error.code === 'NOT_FOUND') {
+		return null;
+	}
+	throw error;
 }
 ```
 
-The thunk is called per request. `shouldUseToken` skips the header on the
-requests you name. No `token` means the middleware is a no-op.
+## Pagination
 
-## Cache middleware
+`relayPaginate(page)` turns a service's `{ data, metadata }` page into a Relay
+`{ edges, pageInfo }` connection, using `item.id` as the cursor:
 
-In-process `Map`, keyed by `method:url`. Default TTL is five minutes. GET
-(and any other non-POST) responses that are `ok` are stored. POST is cached
-only when `shouldCachePostRequest` says so — the default is "the URL contains
-`/search`".
+```ts
+import { RESTDataSource, relayPaginate } from '@nxgt/datasource-rest';
 
-This is a process cache, not Redis. Two instances of the datasource do not
-share it.
+export class Bookmarks extends RESTDataSource<ClientOperations> {
+	async bookmarks(first: number) {
+		return relayPaginate(
+			await this.data(this.get('/bookmarks', { query: { first } })),
+		);
+	}
+}
+```
 
-## Errors
+## API
 
-`errorToException(error, response)` maps HTTP status to `CustomException`:
+### Classes
 
-| Status | `ErrorCode` |
-| --- | --- |
-| 401 | `Unauthenticated` |
-| 403 | `Forbidden` |
-| 404 | `NotFound` |
-| 500 | `InternalServerError` |
-| other | `BadRequest` |
-
-A downstream 404 is `NotFound`, not a transport failure. Catch
-`CustomException`, not an error named after the HTTP library.
-
-`relayPaginate(data)` turns a REST `{ data, metadata }` page into a Relay
-`{ edges, pageInfo }` connection, using `item.id` as the cursor.
-
-## Things that bite
-
-- **The cache is per process and unbounded except by TTL.** Do not point it at
-  an endpoint that varies by caller unless `shouldUseToken` / the URL already
-  distinguish them.
-- **`authOptions.token` as a thunk is not awaited by the middleware today.**
-  Pass a string, or a thunk that returns a string synchronously, until that
-  is a real `async` `onRequest`.
+#### `RESTDataSource`
+
+```ts
+class RESTDataSource<
+	Ops extends OperationsShape<Ops>, // ClientOperations, generated
+	Routes = RoutesOf<Ops>,
+	Decoded extends boolean = true,
+> {
+	constructor(options: RESTDataSourceOptions<Ops> & { decode?: Decoded });
+	static for(operations: OperationTable<Ops>, options?: { decode?: boolean }): BoundDataSource<Ops, Decoded>;
+	readonly api: OpenApiClient<Ops, Routes, Decoded>;
+	data<R extends { readonly status: number; readonly data: unknown }>(
+		call: Promise<R>,
+	): Promise<Success<R>['data']>;
+	// and PathMethods<Ops, Routes, Decoded>: get, post, query…
+}
+```
+
+The class to extend, one per service; see [Usage](#usage). `RESTDataSource`
+is both a constructor and a type, the datasource's own members and the
+spec's path methods. With `Decoded` set to `false`, the options require
+`decode: false`.
+
+| Option | Type | Default | Description |
+| --- | --- | --- | --- |
+| `baseUrl` | `string` | required | The service's base URL. |
+| `operations` | `OperationTable<Ops>` | required | The `operations` table generated from the service's spec. |
+| `token` | `string \| null \| undefined \| (() => … \| Promise<…>)` | none | Sent as `Authorization: Bearer <token>`. A function is read, and awaited, before each request. None, or a nullish result, sends no header. |
+| `cache` | `Cache \| false` | `defaultCache` | The replies cache: your own `cache()` from `@nxgt/httpyz`, or `false` for none. See [Cache](#cache). |
+| `http` | `Omit<HttpClientOptions, 'baseUrl' \| 'auth'>` | `{}` | What else the core client takes: `headers`, `timeout`, `retry`, `use`, `fetch`… Its `use` runs inside the cache. |
+| `validate` | `boolean \| { request?: boolean; response?: boolean }` | both | Checks the request and the reply with the spec's schemas, as `createOpenApiClient` does. `false`: neither. |
+| `decode` | `Decoded` | `true` | Returns each reply as its schema outputs it. `false` returns it as JSON carries it. |
+
+| Member | Type | Description |
+| --- | --- | --- |
+| `api` | `OpenApiClient<Ops, Routes, Decoded>` | The client bound to the spec, for `op()`, `stream()`, `group()` and `operations`. |
+| `data(call)` | `Promise<Success<R>['data']>` | The data of `call`'s 2xx reply. Any other reply, or none, throws a `DataSourceError`; an abort is rethrown as it is. The body of a status the spec does not declare is read for its message. |
+| `get`, `put`, `post`, `delete`, `options`, `head`, `patch`, `trace`, `query` | `PathMethods<Ops, Routes, Decoded>[M]` | `this.api[method]`, for the methods the spec has an operation for only, in the types and at runtime: `(path, ...args) => Promise<reply>`. Set on each datasource, so a subclass's method of the same name wins. |
+
+#### `RESTDataSource.for`
+
+```ts
+RESTDataSource.for<Ops extends OperationsShape<Ops>>(operations: OperationTable<Ops>): BoundDataSource<Ops, true>;
+RESTDataSource.for<Ops extends OperationsShape<Ops>>(
+	operations: OperationTable<Ops>,
+	options: { readonly decode: false },
+): BoundDataSource<Ops, false>;
+```
+
+A datasource class bound to the generated `operations` table, which takes
+its types from it: `class Bookmarks extends RESTDataSource.for(operations)`,
+with no `ClientOperations` to import. Its constructor takes every option but
+`operations`. With `{ decode: false }`, its replies are returned as JSON
+carries them. See [Usage](#usage).
+
+#### `DataSourceError`
+
+```ts
+class DataSourceError extends Error {
+	constructor(message: string, options: DataSourceErrorOptions);
+	readonly name: 'DataSourceError';
+	readonly code: DataSourceErrorCode;
+	readonly status: number | undefined;
+	readonly data: unknown;
+	readonly issues: readonly ValidationIssue[] | undefined;
+	readonly extensions: {
+		readonly code: DataSourceErrorCode;
+		readonly status: number | undefined;
+	};
+}
+```
+
+Every way a call to a service fails; see [Errors](#errors). The constructor
+passes `cause`, and any other `ErrorOptions`, on to `Error`.
+
+| Property | Type | Description |
+| --- | --- | --- |
+| `name` | `'DataSourceError'` | |
+| `message` | `string` | The reply body's `message`, or the client error's; `'An error occurred'` when what was thrown is not an `Error`. |
+| `code` | `DataSourceErrorCode` | What failed, from the reply's status or the lack of one. |
+| `status` | `number \| undefined` | The status of the service's reply; none when no reply came back. |
+| `data` | `unknown` | The reply's body, as the service sent it; none when no reply was read. |
+| `issues` | `readonly ValidationIssue[] \| undefined` | What a `validate` or `decode` check refused, in the request or the reply, as `@nxgt/httpyz` has them; none otherwise. |
+| `extensions` | `{ code, status }` | What a GraphQL server reports with the error: graphql-js reads `extensions` off the error a resolver throws. |
+| `cause` | `unknown` | What was thrown, when `toDataSourceError` made the error: the client's own error, or anything else. |
+
+### Functions
+
+#### `toDataSourceError`
+
+```ts
+function toDataSourceError(error: unknown, data?: unknown): DataSourceError;
+```
+
+`error` as a `DataSourceError`, whatever the client threw; a
+`DataSourceError` is returned as it is. `data` is the body of a reply the
+error does not carry, an `UndeclaredStatusError`'s, which only a read of its
+response gives. It codes as the table in [Errors](#errors) says, and never
+throws.
+
+#### `codeOf`
+
+```ts
+function codeOf(status: number): DataSourceErrorCode;
+```
+
+The code of a reply's status: 401, 403 and 404 by name, any 5xx
+`INTERNAL_SERVER_ERROR`, any other `BAD_REQUEST`.
+
+#### `relayPaginate`
+
+```ts
+function relayPaginate<T extends { id: string }>(
+	page: Paginated<T>,
+): Connection<T>;
+```
+
+A service's page as a Relay connection: each item an edge, its `id` the
+cursor, `metadata` the `pageInfo`. A page without `data` has no edges; one
+without `metadata` gets the `pageInfo` of an empty last page,
+`{ hasNextPage: false, totalElements: 0 }`, even when it has items. See
+[Pagination](#pagination).
+
+### Constants
+
+#### `defaultCache`
+
+```ts
+const defaultCache: Cache; // Middleware & { clear(): void }
+```
+
+`cache()` from `@nxgt/httpyz` with its defaults, shared by every datasource
+not given its own `cache`. `defaultCache.clear()` empties it. See
+[Cache](#cache).
+
+### Types
+
+#### `RESTDataSourceOptions`
+
+```ts
+interface RESTDataSourceOptions<Ops> extends OpenApiOptions {
+	baseUrl: string;
+	operations: OperationTable<Ops>;
+	token?: Token | (() => Token | Promise<Token>); // Token: string | null | undefined
+	cache?: Cache | false;
+	http?: Omit<HttpClientOptions, 'baseUrl' | 'auth'>;
+}
+```
+
+What the `RESTDataSource` constructor takes, with `decode`; each option is in
+[its table](#restdatasource).
+
+#### `BoundDataSource`
+
+```ts
+type BoundDataSource<Ops extends OperationsShape<Ops>, Decoded extends boolean = true> = new (
+	options: Omit<RESTDataSourceOptions<Ops>, 'operations'>,
+) => RESTDataSource<Ops, RoutesOf<Ops>, Decoded>;
+```
+
+What [`RESTDataSource.for`](#restdatasourcefor) returns: a datasource class
+bound to its table, to extend.
+
+#### `DataSourceErrorCode`
+
+```ts
+type DataSourceErrorCode =
+	| 'BAD_REQUEST'
+	| 'UNAUTHENTICATED'
+	| 'FORBIDDEN'
+	| 'NOT_FOUND'
+	| 'INTERNAL_SERVER_ERROR'
+	| 'SERVICE_UNAVAILABLE';
+```
+
+A `DataSourceError`'s `code`, and what `codeOf` returns.
+
+#### `DataSourceErrorOptions`
+
+```ts
+interface DataSourceErrorOptions extends ErrorOptions {
+	readonly code: DataSourceErrorCode;
+	readonly status?: number | undefined;
+	readonly data?: unknown;
+	readonly issues?: readonly ValidationIssue[] | undefined;
+}
+```
+
+The second argument of `new DataSourceError()`.
+
+#### `Paginated`
+
+| Field | Type | Description |
+| --- | --- | --- |
+| `data` | `T[]`, optional | The page's items. |
+| `metadata` | `PageInfo`, optional | Where the page stands. |
+
+A page as a service sends it: what `relayPaginate` takes.
+
+#### `Connection`
+
+| Field | Type | Description |
+| --- | --- | --- |
+| `edges` | `Edge<T>[]` | One per item. |
+| `pageInfo` | `PageInfo` | Where the page stands. |
+
+The Relay connection `relayPaginate` returns.
+
+#### `Edge`
+
+| Field | Type | Description |
+| --- | --- | --- |
+| `node` | `T` | The item. |
+| `cursor` | `string` | The item's `id`. |
+
+An item of a `Connection`.
+
+#### `PageInfo`
+
+| Field | Type | Description |
+| --- | --- | --- |
+| `startCursor` | `string`, optional | The cursor of the first item in the result set. |
+| `endCursor` | `string`, optional | The cursor of the last item in the result set. |
+| `hasNextPage` | `boolean` | Whether there are more items after the current page. |
+| `totalElements` | `number` | The number of items across all pages. |
+
+A `Paginated`'s `metadata`, and a `Connection`'s `pageInfo`, as it is.
+
+## Traps
+
+- **The cache is per process.** Two instances of a service do not share it,
+  so each may answer from its own for up to five minutes: give reads that must
+  be fresh `cache: false`, or a `cache({ ttl })` of your own.
+- **A write does not empty the cache.** A read made after it may be answered
+  from memory: call `defaultCache.clear()` after the write.
+- **An aborted call throws its abort**, not a `DataSourceError`: it was not
+  the service failing. Tell it apart with `isAbortError(error)` from
+  `@nxgt/httpyz`.
+- **`this.data` reads the body of an undeclared status** to find its message.
+  A reply the spec declares is already read; declare the error statuses the
+  service replies with.

package/dist/datasource/rest-datasource.d.ts

@@ -0,0 +1,95 @@
+/**
+ * `RESTDataSource`: a REST service, called from a GraphQL resolver or any
+ * server code, through the client `@nxgt/openapi-httpyz` binds to its spec.
+ * The caller's token is forwarded, reads are cached, and a call that fails
+ * becomes one `DataSourceError`.
+ */
+import { type Cache, type HttpClientOptions, type Success } from '@nxgt/httpyz';
+import { type OpenApiClient, type OpenApiOptions, type OperationsShape, type OperationTable, type PathMethods, type RoutesOf } from '@nxgt/openapi-httpyz';
+type Token = string | null | undefined;
+/**
+ * The cache every datasource shares unless it is given its own: a server
+ * makes its datasources per request, and each would otherwise start empty.
+ * It keeps the reads, `GET`, `HEAD` and `QUERY`, a search by what it searches
+ * for. It is keyed by the caller's token, so no caller is answered with
+ * another's reply. `defaultCache.clear()` empties it.
+ */
+export declare const defaultCache: Cache;
+export interface RESTDataSourceOptions<Ops> extends OpenApiOptions {
+    /** The service's base URL. */
+    baseUrl: string;
+    /** The `operations` table generated from the service's spec. */
+    operations: OperationTable<Ops>;
+    /**
+     * Sent as `Authorization: Bearer <token>`: the caller's, forwarded. A
+     * function is read, and awaited, before each request. None sends no header.
+     */
+    token?: Token | (() => Token | Promise<Token>);
+    /** Default: `defaultCache`, shared by every datasource. `false`: none. */
+    cache?: Cache | false;
+    /** What else the core client takes: `headers`, `timeout`, `retry`, `use`, `fetch`… */
+    http?: Omit<HttpClientOptions, 'baseUrl' | 'auth'>;
+}
+/** `decode`, as the binding takes it: a datasource typed as not decoding must say `decode: false`. */
+type Decoding<Decoded extends boolean> = {
+    readonly decode?: Decoded;
+} & (Decoded extends false ? {
+    readonly decode: false;
+} : unknown);
+/** The datasource's own members; `RESTDataSource` adds the client's path methods. */
+declare class DataSource<Ops extends OperationsShape<Ops>, Routes, Decoded extends boolean> {
+    /** The client bound to the spec, for `op()`, `stream()` and `group()`. */
+    readonly api: OpenApiClient<Ops, Routes, Decoded>;
+    /**
+     * A datasource class bound to `operations`, whose types it takes from the
+     * generated table: no `ClientOperations` to import. Its constructor takes
+     * the other options.
+     */
+    static for(operations: object, fixed?: {
+        readonly decode?: boolean;
+    }): {
+        new (options: object): {};
+    };
+    constructor(options: RESTDataSourceOptions<Ops> & Decoding<Decoded>);
+    /**
+     * The data of a call's 2xx reply. Any other reply, or none, throws a
+     * `DataSourceError`; an aborted call throws its abort, as it is.
+     */
+    data<R extends {
+        readonly status: number;
+        readonly data: unknown;
+    }>(call: Promise<R>): Promise<Success<R>['data']>;
+}
+/**
+ * A datasource for a service, typed by the `ClientOperations` generated from
+ * its spec. It has the client's `get`, `post`… for each method the spec has
+ * an operation for. Extend it with the calls a resolver makes:
+ *
+ * ```ts
+ * class Bookmarks extends RESTDataSource.for(operations) {
+ * 	bookmark(id: string) {
+ * 		return this.data(this.get('/bookmarks/{id}', { param: { id } }));
+ * 	}
+ * }
+ * new Bookmarks({ baseUrl, token: () => context.token });
+ * ```
+ */
+export type RESTDataSource<Ops extends OperationsShape<Ops>, Routes = RoutesOf<Ops>, Decoded extends boolean = true> = DataSource<Ops, Routes, Decoded> & PathMethods<Ops, Routes, Decoded>;
+/** What `RESTDataSource.for(operations)` returns: a datasource class bound to the table. */
+export type BoundDataSource<Ops extends OperationsShape<Ops>, Decoded extends boolean = true> = new (options: Omit<RESTDataSourceOptions<Ops>, 'operations'>) => RESTDataSource<Ops, RoutesOf<Ops>, Decoded>;
+export declare const RESTDataSource: {
+    new <Ops extends OperationsShape<Ops>, Routes = RoutesOf<Ops>, Decoded extends boolean = true>(options: RESTDataSourceOptions<Ops> & Decoding<Decoded>): RESTDataSource<Ops, Routes, Decoded>;
+    /**
+     * A datasource class bound to `operations`, whose types it takes from the
+     * generated table: `class Bookmarks extends RESTDataSource.for(operations)`.
+     * `{ decode: false }` returns the replies as JSON carries them.
+     */
+    for<Ops extends OperationsShape<Ops>>(operations: OperationTable<Ops>, options: {
+        readonly decode: false;
+    }): BoundDataSource<Ops, false>;
+    for<Ops extends OperationsShape<Ops>>(operations: OperationTable<Ops>, options?: {
+        readonly decode?: true;
+    }): BoundDataSource<Ops, true>;
+};
+export {};
+//# sourceMappingURL=rest-datasource.d.ts.map

package/dist/datasource/rest-datasource.d.ts.map

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

package/dist/errors/data-source-error.d.ts

@@ -0,0 +1,41 @@
+/**
+ * `DataSourceError`: every way a call to a service can fail, as one error
+ * with a code a GraphQL server reports. It is the package's own, and depends
+ * on no exception package of the app's: map it to yours where you catch it.
+ */
+import { type ValidationIssue } from '@nxgt/httpyz';
+export type DataSourceErrorCode = 'BAD_REQUEST' | 'UNAUTHENTICATED' | 'FORBIDDEN' | 'NOT_FOUND' | 'INTERNAL_SERVER_ERROR' | 'SERVICE_UNAVAILABLE';
+export interface DataSourceErrorOptions extends ErrorOptions {
+    readonly code: DataSourceErrorCode;
+    readonly status?: number | undefined;
+    readonly data?: unknown;
+    readonly issues?: readonly ValidationIssue[] | undefined;
+}
+export declare class DataSourceError extends Error {
+    readonly name = "DataSourceError";
+    readonly code: DataSourceErrorCode;
+    /** The status of the service's reply; none when no reply came back. */
+    readonly status: number | undefined;
+    /** The body of the service's reply, as it sent it; none when no reply was read. */
+    readonly data: unknown;
+    /** What a `validate` check refused, in the request or the reply; none otherwise. */
+    readonly issues: readonly ValidationIssue[] | undefined;
+    /**
+     * What a GraphQL server reports with the error: graphql-js reads
+     * `extensions` off the error a resolver throws.
+     */
+    readonly extensions: {
+        readonly code: DataSourceErrorCode;
+        readonly status: number | undefined;
+    };
+    constructor(message: string, { code, status, data, issues, ...options }: DataSourceErrorOptions);
+}
+/** The code of a reply's status: any 5xx is the service's failure, any other 4xx a bad request. */
+export declare function codeOf(status: number): DataSourceErrorCode;
+/**
+ * `error` as a `DataSourceError`, whatever the client threw. `data` is the
+ * body of a reply the error does not carry: an `UndeclaredStatusError`'s,
+ * which only a read of its response gives.
+ */
+export declare function toDataSourceError(error: unknown, data?: unknown): DataSourceError;
+//# sourceMappingURL=data-source-error.d.ts.map

package/dist/errors/data-source-error.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"data-source-error.d.ts","sourceRoot":"","sources":["../../src/errors/data-source-error.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,EAMN,KAAK,eAAe,EACpB,MAAM,cAAc,CAAC;AAEtB,MAAM,MAAM,mBAAmB,GAC5B,aAAa,GACb,iBAAiB,GACjB,WAAW,GACX,WAAW,GACX,uBAAuB,GACvB,qBAAqB,CAAC;AAEzB,MAAM,WAAW,sBAAuB,SAAQ,YAAY;IAC3D,QAAQ,CAAC,IAAI,EAAE,mBAAmB,CAAC;IACnC,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACrC,QAAQ,CAAC,IAAI,CAAC,EAAE,OAAO,CAAC;IACxB,QAAQ,CAAC,MAAM,CAAC,EAAE,SAAS,eAAe,EAAE,GAAG,SAAS,CAAC;CACzD;AAED,qBAAa,eAAgB,SAAQ,KAAK;IACzC,SAAkB,IAAI,qBAAqB;IAC3C,QAAQ,CAAC,IAAI,EAAE,mBAAmB,CAAC;IACnC,uEAAuE;IACvE,QAAQ,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC;IACpC,mFAAmF;IACnF,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAC;IACvB,oFAAoF;IACpF,QAAQ,CAAC,MAAM,EAAE,SAAS,eAAe,EAAE,GAAG,SAAS,CAAC;IACxD;;;OAGG;IACH,QAAQ,CAAC,UAAU,EAAE;QACpB,QAAQ,CAAC,IAAI,EAAE,mBAAmB,CAAC;QACnC,QAAQ,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC;KACpC,CAAC;gBAGD,OAAO,EAAE,MAAM,EACf,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,GAAG,OAAO,EAAE,EAAE,sBAAsB;CASnE;AAED,mGAAmG;AACnG,wBAAgB,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,mBAAmB,CAM1D;AAYD;;;;GAIG;AACH,wBAAgB,iBAAiB,CAChC,KAAK,EAAE,OAAO,EACd,IAAI,CAAC,EAAE,OAAO,GACZ,eAAe,CAwCjB"}

package/dist/index.d.ts

@@ -1,4 +1,5 @@
-export * from './helpers';
-export * from './middlewares';
-export * from './rest-datasource';
+export { type BoundDataSource, defaultCache, RESTDataSource, type RESTDataSourceOptions, } from './datasource/rest-datasource';
+export { codeOf, DataSourceError, type DataSourceErrorCode, type DataSourceErrorOptions, toDataSourceError, } from './errors/data-source-error';
+export { relayPaginate } from './pagination/relay';
+export type { Connection, Edge, PageInfo, Paginated } from './pagination/types';
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,WAAW,CAAC;AAC1B,cAAc,eAAe,CAAC;AAC9B,cAAc,mBAAmB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACN,KAAK,eAAe,EACpB,YAAY,EACZ,cAAc,EACd,KAAK,qBAAqB,GAC1B,MAAM,8BAA8B,CAAC;AACtC,OAAO,EACN,MAAM,EACN,eAAe,EACf,KAAK,mBAAmB,EACxB,KAAK,sBAAsB,EAC3B,iBAAiB,GACjB,MAAM,4BAA4B,CAAC;AACpC,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AACnD,YAAY,EAAE,UAAU,EAAE,IAAI,EAAE,QAAQ,EAAE,SAAS,EAAE,MAAM,oBAAoB,CAAC"}

package/dist/index.js

@@ -1,38 +1,153 @@
-// src/helpers/error-handling.ts
-import { CustomException, ErrorCode } from "@nxgt/shared-exceptions";
-function errorToException(error, response) {
-  let status = ErrorCode.BadRequest;
-  switch (response.status) {
-    case 401:
-      status = ErrorCode.Unauthenticated;
-      break;
-    case 403:
-      status = ErrorCode.Forbidden;
-      break;
-    case 404:
-      status = ErrorCode.NotFound;
-      break;
-    case 500:
-      status = ErrorCode.InternalServerError;
-      break;
-    default:
-      status = ErrorCode.BadRequest;
+// src/datasource/rest-datasource.ts
+import {
+  createHttpClient,
+  isAbortError,
+  ok,
+  cache as replies,
+  UndeclaredStatusError as UndeclaredStatusError2
+} from "@nxgt/httpyz";
+import { METHODS } from "@nxgt/httpyz/integration";
+import {
+  createOpenApiClient
+} from "@nxgt/openapi-httpyz";
+
+// src/errors/data-source-error.ts
+import {
+  NetworkError,
+  ReplyStatusError,
+  TimeoutError,
+  UndeclaredStatusError,
+  ValidationError
+} from "@nxgt/httpyz";
+
+class DataSourceError extends Error {
+  constructor(message, { code, status, data, issues, ...options }) {
+    super(message, options);
+    this.name = "DataSourceError";
+    this.code = code;
+    this.status = status;
+    this.data = data;
+    this.issues = issues;
+    this.extensions = { code, status };
+  }
+}
+function codeOf(status) {
+  if (status === 401)
+    return "UNAUTHENTICATED";
+  if (status === 403)
+    return "FORBIDDEN";
+  if (status === 404)
+    return "NOT_FOUND";
+  if (status >= 500)
+    return "INTERNAL_SERVER_ERROR";
+  return "BAD_REQUEST";
+}
+var messageOf = (data, fallback) => typeof data === "object" && data !== null && ("message" in data) && typeof data.message === "string" && data.message !== "" ? data.message : fallback;
+function toDataSourceError(error, data) {
+  if (error instanceof DataSourceError)
+    return error;
+  if (error instanceof ReplyStatusError) {
+    return new DataSourceError(messageOf(error.data, error.message), {
+      code: codeOf(error.status),
+      status: error.status,
+      data: error.data,
+      cause: error
+    });
+  }
+  if (error instanceof UndeclaredStatusError) {
+    return new DataSourceError(messageOf(data, error.message), {
+      code: codeOf(error.status),
+      status: error.status,
+      data,
+      cause: error
+    });
+  }
+  if (error instanceof NetworkError || error instanceof TimeoutError) {
+    return new DataSourceError(error.message, {
+      code: "SERVICE_UNAVAILABLE",
+      cause: error
+    });
+  }
+  if (error instanceof ValidationError) {
+    return new DataSourceError(error.message, {
+      code: error.failure.kind === "request" ? "BAD_REQUEST" : "INTERNAL_SERVER_ERROR",
+      status: error.failure.status,
+      issues: error.failure.issues,
+      cause: error
+    });
+  }
+  return new DataSourceError(error instanceof Error ? error.message : "An error occurred", { code: "INTERNAL_SERVER_ERROR", cause: error });
+}
+
+// src/datasource/rest-datasource.ts
+var defaultCache = replies();
+
+class DataSource {
+  static for(operations, fixed = {}) {
+    const Base = DataSource;
+    return class extends Base {
+      constructor(options) {
+        super({ ...options, ...fixed, operations });
+      }
+    };
+  }
+  constructor(options) {
+    const {
+      baseUrl,
+      operations,
+      token,
+      cache = defaultCache,
+      http = {},
+      ...binding
+    } = options;
+    const client = createHttpClient({
+      ...http,
+      baseUrl,
+      ...token === undefined ? {} : {
+        auth: { token: typeof token === "function" ? token : () => token }
+      },
+      use: [...cache ? [cache] : [], ...http.use ?? []]
+    });
+    this.api = createOpenApiClient(client, operations, ...[binding]);
+    const api = this.api;
+    for (const method of METHODS) {
+      if (method in api && !(method in this)) {
+        Object.defineProperty(this, method, {
+          configurable: true,
+          writable: true,
+          value: api[method]
+        });
+      }
+    }
+  }
+  async data(call) {
+    try {
+      return ok(await call);
+    } catch (error) {
+      if (isAbortError(error))
+        throw error;
+      throw toDataSourceError(error, error instanceof UndeclaredStatusError2 ? await bodyOf(error.response) : undefined);
+    }
   }
-  return CustomException.from({
-    message: error?.message || "An error occurred",
-    code: status,
-    options: {},
-    debugMessage: error?.debugMessage
+}
+var RESTDataSource = DataSource;
+async function bodyOf(response) {
+  const text = await response.clone().text().catch(() => {
+    return;
   });
+  if (!text)
+    return;
+  try {
+    return JSON.parse(text);
+  } catch {
+    return text;
+  }
 }
-// src/helpers/pagination.utils.ts
-function relayPaginate(data) {
-  const { data: items, metadata } = data;
+// src/pagination/relay.ts
+function relayPaginate(page) {
+  const { data: items, metadata } = page;
   return {
-    edges: (items ?? []).map((item) => ({
-      node: item,
-      cursor: item.id
-    })),
+    edges: (items ?? []).map((item) => ({ node: item, cursor: item.id })),
     pageInfo: metadata ?? {
       startCursor: undefined,
       endCursor: undefined,
@@ -41,71 +156,14 @@ function relayPaginate(data) {
     }
   };
 }
-// src/middlewares/auth.middleware.ts
-var authMiddleware = (options) => ({
-  onRequest({ request }) {
-    if (!options.token) {
-      return;
-    }
-    if (options.shouldUseToken && !options.shouldUseToken(request)) {
-      return;
-    }
-    request.headers.set("Authorization", `Bearer ${typeof options.token === "function" ? options.token() : options.token}`);
-  }
-});
-// src/middlewares/cache.middleware.ts
-var cache = new Map;
-var getCacheKey = (request) => `${request.method}:${request.url}`;
-var cacheMiddleware = ({
-  ttl = 5 * 60 * 1000,
-  shouldCachePostRequest = (req) => req.url.includes("/search")
-} = {}) => ({
-  onRequest({ request }) {
-    const key = getCacheKey(request);
-    const cached = cache.get(key);
-    if (cached && cached.expiry > Date.now()) {
-      return cached.value.clone();
-    }
-    cache.delete(key);
-  },
-  onResponse({ request, response }) {
-    if (response.ok) {
-      if (request.method === "POST" && !shouldCachePostRequest?.(request)) {
-        return;
-      }
-      const key = getCacheKey(request);
-      cache.set(key, {
-        expiry: Date.now() + ttl,
-        value: response.clone()
-      });
-    }
-  }
-});
-// src/rest-datasource.ts
-class RESTDataSource {
-  constructor(options) {
-    this.client = options.client;
-    this.client.use(cacheMiddleware(options.cacheOptions));
-    if (options.authOptions) {
-      this.client.use(authMiddleware(options.authOptions));
-    }
-    this.get = this.client.GET;
-    this.post = this.client.POST;
-    this.put = this.client.PUT;
-    this.patch = this.client.PATCH;
-    this.delete = this.client.DELETE;
-    this.head = this.client.HEAD;
-    this.options = this.client.OPTIONS;
-    this.trace = this.client.TRACE;
-  }
-}
 export {
+  DataSourceError,
   RESTDataSource,
-  authMiddleware,
-  cacheMiddleware,
-  errorToException,
-  relayPaginate
+  codeOf,
+  defaultCache,
+  relayPaginate,
+  toDataSourceError
 };
 
-//# debugId=B0900E11F81FD7B064756E2164756E21
+//# debugId=F26F117CA5680FFB64756E2164756E21
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1,14 +1,12 @@
 {
   "version": 3,
-  "sources": ["../src/helpers/error-handling.ts", "../src/helpers/pagination.utils.ts", "../src/middlewares/auth.middleware.ts", "../src/middlewares/cache.middleware.ts", "../src/rest-datasource.ts"],
+  "sources": ["../src/datasource/rest-datasource.ts", "../src/errors/data-source-error.ts", "../src/pagination/relay.ts"],
   "sourcesContent": [
-    "import { CustomException, ErrorCode } from '@nxgt/shared-exceptions';\n\nexport function errorToException(error: any, response: Response) {\n\tlet status = ErrorCode.BadRequest;\n\tswitch (response.status) {\n\t\tcase 401:\n\t\t\tstatus = ErrorCode.Unauthenticated;\n\t\t\tbreak;\n\t\tcase 403:\n\t\t\tstatus = ErrorCode.Forbidden;\n\t\t\tbreak;\n\t\tcase 404:\n\t\t\tstatus = ErrorCode.NotFound;\n\t\t\tbreak;\n\t\tcase 500:\n\t\t\tstatus = ErrorCode.InternalServerError;\n\t\t\tbreak;\n\t\tdefault:\n\t\t\tstatus = ErrorCode.BadRequest;\n\t}\n\n\treturn CustomException.from({\n\t\tmessage: error?.message || 'An error occurred',\n\t\tcode: status,\n\t\toptions: {},\n\t\tdebugMessage: error?.debugMessage,\n\t});\n}\n",
-    "import type { Connection, Paginated } from '../types';\n\nexport function relayPaginate<T extends { id: string }>(\n\tdata: Paginated<T>,\n): Connection<T> {\n\tconst { data: items, metadata } = data;\n\treturn {\n\t\tedges: (items ?? []).map((item) => ({\n\t\t\tnode: item,\n\t\t\tcursor: item.id,\n\t\t})),\n\t\tpageInfo: metadata ?? {\n\t\t\tstartCursor: undefined,\n\t\t\tendCursor: undefined,\n\t\t\thasNextPage: false,\n\t\t\ttotalElements: 0,\n\t\t},\n\t};\n}\n",
-    "import type { Middleware } from 'openapi-fetch';\n\nexport type AuthMiddlewareOptions = {\n\ttoken?: string | (() => Promise<string>);\n\tshouldUseToken?: (request: Request) => boolean;\n};\n\nexport const authMiddleware = (options: AuthMiddlewareOptions): Middleware => ({\n\tonRequest({ request }) {\n\t\tif (!options.token) {\n\t\t\treturn;\n\t\t}\n\t\tif (options.shouldUseToken && !options.shouldUseToken(request)) {\n\t\t\treturn;\n\t\t}\n\t\trequest.headers.set(\n\t\t\t'Authorization',\n\t\t\t`Bearer ${typeof options.token === 'function' ? options.token() : options.token}`,\n\t\t);\n\t},\n});\n",
-    "import type { Middleware } from 'openapi-fetch';\n\nconst cache = new Map<string, { expiry: number; value: Response }>();\nconst getCacheKey = (request: Request) => `${request.method}:${request.url}`;\n\nexport type CacheMiddlewareOptions = {\n\tttl?: number;\n\tshouldCachePostRequest?: (req: Request) => boolean;\n};\n\nexport const cacheMiddleware = ({\n\tttl = 5 * 60 * 1000, // default TTL: 5 minutes\n\tshouldCachePostRequest = (req) => req.url.includes('/search'),\n}: CacheMiddlewareOptions = {}): Middleware => ({\n\tonRequest({ request }) {\n\t\tconst key = getCacheKey(request);\n\t\tconst cached = cache.get(key);\n\t\tif (cached && cached.expiry > Date.now()) {\n\t\t\treturn cached.value.clone();\n\t\t}\n\t\tcache.delete(key);\n\t},\n\tonResponse({ request, response }) {\n\t\tif (response.ok) {\n\t\t\tif (request.method === 'POST' && !shouldCachePostRequest?.(request)) {\n\t\t\t\treturn;\n\t\t\t}\n\t\t\tconst key = getCacheKey(request);\n\t\t\tcache.set(key, {\n\t\t\t\texpiry: Date.now() + ttl,\n\t\t\t\tvalue: response.clone(),\n\t\t\t});\n\t\t}\n\t},\n});\n",
-    "import type { Client, ClientMethod } from 'openapi-fetch';\nimport {\n\ttype AuthMiddlewareOptions,\n\tauthMiddleware,\n\ttype CacheMiddlewareOptions,\n\tcacheMiddleware,\n} from './middlewares';\nimport type { MediaType } from './types';\n\nexport type RESTDataSourceOptions<\n\tPaths extends {},\n\tMedia extends MediaType = MediaType,\n> = {\n\tclient: Client<Paths, Media>;\n\tcacheOptions?: CacheMiddlewareOptions;\n\tauthOptions?: AuthMiddlewareOptions;\n};\n\nexport class RESTDataSource<\n\tPaths extends {},\n\tMedia extends MediaType = MediaType,\n> {\n\tprotected client: Client<Paths, Media>;\n\n\tget: ClientMethod<Paths, 'get', Media>;\n\tpost: ClientMethod<Paths, 'post', Media>;\n\tput: ClientMethod<Paths, 'put', Media>;\n\tpatch: ClientMethod<Paths, 'patch', Media>;\n\tdelete: ClientMethod<Paths, 'delete', Media>;\n\thead: ClientMethod<Paths, 'head', Media>;\n\toptions: ClientMethod<Paths, 'options', Media>;\n\ttrace: ClientMethod<Paths, 'trace', Media>;\n\n\tconstructor(options: RESTDataSourceOptions<Paths, Media>) {\n\t\tthis.client = options.client;\n\t\tthis.client.use(cacheMiddleware(options.cacheOptions));\n\t\tif (options.authOptions) {\n\t\t\tthis.client.use(authMiddleware(options.authOptions));\n\t\t}\n\t\tthis.get = this.client.GET;\n\t\tthis.post = this.client.POST;\n\t\tthis.put = this.client.PUT;\n\t\tthis.patch = this.client.PATCH;\n\t\tthis.delete = this.client.DELETE;\n\t\tthis.head = this.client.HEAD;\n\t\tthis.options = this.client.OPTIONS;\n\t\tthis.trace = this.client.TRACE;\n\t}\n}\n"
+    "/**\n * `RESTDataSource`: a REST service, called from a GraphQL resolver or any\n * server code, through the client `@nxgt/openapi-httpyz` binds to its spec.\n * The caller's token is forwarded, reads are cached, and a call that fails\n * becomes one `DataSourceError`.\n */\nimport {\n\ttype Cache,\n\tcreateHttpClient,\n\ttype HttpClientOptions,\n\tisAbortError,\n\tok,\n\tcache as replies,\n\ttype Success,\n\tUndeclaredStatusError,\n} from '@nxgt/httpyz';\nimport { METHODS } from '@nxgt/httpyz/integration';\nimport {\n\tcreateOpenApiClient,\n\ttype OpenApiArgs,\n\ttype OpenApiClient,\n\ttype OpenApiOptions,\n\ttype OperationsShape,\n\ttype OperationTable,\n\ttype PathMethods,\n\ttype RoutesOf,\n} from '@nxgt/openapi-httpyz';\nimport { toDataSourceError } from '../errors/data-source-error';\n\ntype Token = string | null | undefined;\n\n/**\n * The cache every datasource shares unless it is given its own: a server\n * makes its datasources per request, and each would otherwise start empty.\n * It keeps the reads, `GET`, `HEAD` and `QUERY`, a search by what it searches\n * for. It is keyed by the caller's token, so no caller is answered with\n * another's reply. `defaultCache.clear()` empties it.\n */\nexport const defaultCache: Cache = replies();\n\nexport interface RESTDataSourceOptions<Ops> extends OpenApiOptions {\n\t/** The service's base URL. */\n\tbaseUrl: string;\n\t/** The `operations` table generated from the service's spec. */\n\toperations: OperationTable<Ops>;\n\t/**\n\t * Sent as `Authorization: Bearer <token>`: the caller's, forwarded. A\n\t * function is read, and awaited, before each request. None sends no header.\n\t */\n\ttoken?: Token | (() => Token | Promise<Token>);\n\t/** Default: `defaultCache`, shared by every datasource. `false`: none. */\n\tcache?: Cache | false;\n\t/** What else the core client takes: `headers`, `timeout`, `retry`, `use`, `fetch`… */\n\thttp?: Omit<HttpClientOptions, 'baseUrl' | 'auth'>;\n}\n\n/** `decode`, as the binding takes it: a datasource typed as not decoding must say `decode: false`. */\ntype Decoding<Decoded extends boolean> = {\n\treadonly decode?: Decoded;\n} & (Decoded extends false ? { readonly decode: false } : unknown);\n\n/** The datasource's own members; `RESTDataSource` adds the client's path methods. */\nclass DataSource<\n\tOps extends OperationsShape<Ops>,\n\tRoutes,\n\tDecoded extends boolean,\n> {\n\t/** The client bound to the spec, for `op()`, `stream()` and `group()`. */\n\treadonly api: OpenApiClient<Ops, Routes, Decoded>;\n\n\t/**\n\t * A datasource class bound to `operations`, whose types it takes from the\n\t * generated table: no `ClientOperations` to import. Its constructor takes\n\t * the other options.\n\t */\n\tstatic for(operations: object, fixed: { readonly decode?: boolean } = {}) {\n\t\tconst Base = DataSource as unknown as new (options: object) => object;\n\t\treturn class extends Base {\n\t\t\tconstructor(options: object) {\n\t\t\t\tsuper({ ...options, ...fixed, operations });\n\t\t\t}\n\t\t};\n\t}\n\n\tconstructor(options: RESTDataSourceOptions<Ops> & Decoding<Decoded>) {\n\t\tconst {\n\t\t\tbaseUrl,\n\t\t\toperations,\n\t\t\ttoken,\n\t\t\tcache = defaultCache,\n\t\t\thttp = {},\n\t\t\t...binding\n\t\t} = options;\n\t\tconst client = createHttpClient({\n\t\t\t...http,\n\t\t\tbaseUrl,\n\t\t\t...(token === undefined\n\t\t\t\t? {}\n\t\t\t\t: {\n\t\t\t\t\t\tauth: { token: typeof token === 'function' ? token : () => token },\n\t\t\t\t\t}),\n\t\t\t// Inside `auth`, so the cache is keyed by the token it sent.\n\t\t\tuse: [...(cache ? [cache] : []), ...(http.use ?? [])],\n\t\t});\n\t\tthis.api = createOpenApiClient<Ops, Routes, Decoded>(\n\t\t\tclient,\n\t\t\toperations,\n\t\t\t// `Decoding` already holds `decode` to `Decoded`.\n\t\t\t...([binding] as unknown as OpenApiArgs<Decoded>),\n\t\t);\n\t\t// `this.get(...)` for `this.api.get(...)`, for the spec's methods only.\n\t\t// A subclass's own `get()` or `delete()` is already there, and wins.\n\t\tconst api = this.api as unknown as Record<string, unknown>;\n\t\tfor (const method of METHODS) {\n\t\t\tif (method in api && !(method in this)) {\n\t\t\t\tObject.defineProperty(this, method, {\n\t\t\t\t\tconfigurable: true,\n\t\t\t\t\twritable: true,\n\t\t\t\t\tvalue: api[method],\n\t\t\t\t});\n\t\t\t}\n\t\t}\n\t}\n\n\t/**\n\t * The data of a call's 2xx reply. Any other reply, or none, throws a\n\t * `DataSourceError`; an aborted call throws its abort, as it is.\n\t */\n\tasync data<R extends { readonly status: number; readonly data: unknown }>(\n\t\tcall: Promise<R>,\n\t): Promise<Success<R>['data']> {\n\t\ttry {\n\t\t\treturn ok(await call);\n\t\t} catch (error) {\n\t\t\tif (isAbortError(error)) throw error;\n\t\t\tthrow toDataSourceError(\n\t\t\t\terror,\n\t\t\t\terror instanceof UndeclaredStatusError\n\t\t\t\t\t? await bodyOf(error.response)\n\t\t\t\t\t: undefined,\n\t\t\t);\n\t\t}\n\t}\n}\n\n/**\n * A datasource for a service, typed by the `ClientOperations` generated from\n * its spec. It has the client's `get`, `post`… for each method the spec has\n * an operation for. Extend it with the calls a resolver makes:\n *\n * ```ts\n * class Bookmarks extends RESTDataSource.for(operations) {\n * \tbookmark(id: string) {\n * \t\treturn this.data(this.get('/bookmarks/{id}', { param: { id } }));\n * \t}\n * }\n * new Bookmarks({ baseUrl, token: () => context.token });\n * ```\n */\nexport type RESTDataSource<\n\tOps extends OperationsShape<Ops>,\n\tRoutes = RoutesOf<Ops>,\n\tDecoded extends boolean = true,\n> = DataSource<Ops, Routes, Decoded> & PathMethods<Ops, Routes, Decoded>;\n\n/** What `RESTDataSource.for(operations)` returns: a datasource class bound to the table. */\nexport type BoundDataSource<\n\tOps extends OperationsShape<Ops>,\n\tDecoded extends boolean = true,\n> = new (\n\toptions: Omit<RESTDataSourceOptions<Ops>, 'operations'>,\n) => RESTDataSource<Ops, RoutesOf<Ops>, Decoded>;\n\nexport const RESTDataSource = DataSource as unknown as {\n\tnew <\n\t\tOps extends OperationsShape<Ops>,\n\t\tRoutes = RoutesOf<Ops>,\n\t\tDecoded extends boolean = true,\n\t>(\n\t\toptions: RESTDataSourceOptions<Ops> & Decoding<Decoded>,\n\t): RESTDataSource<Ops, Routes, Decoded>;\n\t/**\n\t * A datasource class bound to `operations`, whose types it takes from the\n\t * generated table: `class Bookmarks extends RESTDataSource.for(operations)`.\n\t * `{ decode: false }` returns the replies as JSON carries them.\n\t */\n\tfor<Ops extends OperationsShape<Ops>>(\n\t\toperations: OperationTable<Ops>,\n\t\toptions: { readonly decode: false },\n\t): BoundDataSource<Ops, false>;\n\tfor<Ops extends OperationsShape<Ops>>(\n\t\toperations: OperationTable<Ops>,\n\t\toptions?: { readonly decode?: true },\n\t): BoundDataSource<Ops, true>;\n};\n\n/** A reply's body: JSON when it parses, its text otherwise, nothing when it cannot be read. */\nasync function bodyOf(response: Response): Promise<unknown> {\n\tconst text = await response\n\t\t.clone()\n\t\t.text()\n\t\t.catch(() => undefined);\n\tif (!text) return undefined;\n\ttry {\n\t\treturn JSON.parse(text);\n\t} catch {\n\t\treturn text;\n\t}\n}\n",
+    "/**\n * `DataSourceError`: every way a call to a service can fail, as one error\n * with a code a GraphQL server reports. It is the package's own, and depends\n * on no exception package of the app's: map it to yours where you catch it.\n */\nimport {\n\tNetworkError,\n\tReplyStatusError,\n\tTimeoutError,\n\tUndeclaredStatusError,\n\tValidationError,\n\ttype ValidationIssue,\n} from '@nxgt/httpyz';\n\nexport type DataSourceErrorCode =\n\t| 'BAD_REQUEST'\n\t| 'UNAUTHENTICATED'\n\t| 'FORBIDDEN'\n\t| 'NOT_FOUND'\n\t| 'INTERNAL_SERVER_ERROR'\n\t| 'SERVICE_UNAVAILABLE';\n\nexport interface DataSourceErrorOptions extends ErrorOptions {\n\treadonly code: DataSourceErrorCode;\n\treadonly status?: number | undefined;\n\treadonly data?: unknown;\n\treadonly issues?: readonly ValidationIssue[] | undefined;\n}\n\nexport class DataSourceError extends Error {\n\toverride readonly name = 'DataSourceError';\n\treadonly code: DataSourceErrorCode;\n\t/** The status of the service's reply; none when no reply came back. */\n\treadonly status: number | undefined;\n\t/** The body of the service's reply, as it sent it; none when no reply was read. */\n\treadonly data: unknown;\n\t/** What a `validate` check refused, in the request or the reply; none otherwise. */\n\treadonly issues: readonly ValidationIssue[] | undefined;\n\t/**\n\t * What a GraphQL server reports with the error: graphql-js reads\n\t * `extensions` off the error a resolver throws.\n\t */\n\treadonly extensions: {\n\t\treadonly code: DataSourceErrorCode;\n\t\treadonly status: number | undefined;\n\t};\n\n\tconstructor(\n\t\tmessage: string,\n\t\t{ code, status, data, issues, ...options }: DataSourceErrorOptions,\n\t) {\n\t\tsuper(message, options);\n\t\tthis.code = code;\n\t\tthis.status = status;\n\t\tthis.data = data;\n\t\tthis.issues = issues;\n\t\tthis.extensions = { code, status };\n\t}\n}\n\n/** The code of a reply's status: any 5xx is the service's failure, any other 4xx a bad request. */\nexport function codeOf(status: number): DataSourceErrorCode {\n\tif (status === 401) return 'UNAUTHENTICATED';\n\tif (status === 403) return 'FORBIDDEN';\n\tif (status === 404) return 'NOT_FOUND';\n\tif (status >= 500) return 'INTERNAL_SERVER_ERROR';\n\treturn 'BAD_REQUEST';\n}\n\n/** The `message` of an error body, as the services write it, or `fallback`. */\nconst messageOf = (data: unknown, fallback: string): string =>\n\ttypeof data === 'object' &&\n\tdata !== null &&\n\t'message' in data &&\n\ttypeof data.message === 'string' &&\n\tdata.message !== ''\n\t\t? data.message\n\t\t: fallback;\n\n/**\n * `error` as a `DataSourceError`, whatever the client threw. `data` is the\n * body of a reply the error does not carry: an `UndeclaredStatusError`'s,\n * which only a read of its response gives.\n */\nexport function toDataSourceError(\n\terror: unknown,\n\tdata?: unknown,\n): DataSourceError {\n\tif (error instanceof DataSourceError) return error;\n\tif (error instanceof ReplyStatusError) {\n\t\treturn new DataSourceError(messageOf(error.data, error.message), {\n\t\t\tcode: codeOf(error.status),\n\t\t\tstatus: error.status,\n\t\t\tdata: error.data,\n\t\t\tcause: error,\n\t\t});\n\t}\n\tif (error instanceof UndeclaredStatusError) {\n\t\treturn new DataSourceError(messageOf(data, error.message), {\n\t\t\tcode: codeOf(error.status),\n\t\t\tstatus: error.status,\n\t\t\tdata,\n\t\t\tcause: error,\n\t\t});\n\t}\n\tif (error instanceof NetworkError || error instanceof TimeoutError) {\n\t\treturn new DataSourceError(error.message, {\n\t\t\tcode: 'SERVICE_UNAVAILABLE',\n\t\t\tcause: error,\n\t\t});\n\t}\n\tif (error instanceof ValidationError) {\n\t\t// A request the spec refuses is the caller's fault; a reply it refuses, the service's.\n\t\treturn new DataSourceError(error.message, {\n\t\t\tcode:\n\t\t\t\terror.failure.kind === 'request'\n\t\t\t\t\t? 'BAD_REQUEST'\n\t\t\t\t\t: 'INTERNAL_SERVER_ERROR',\n\t\t\tstatus: error.failure.status,\n\t\t\tissues: error.failure.issues,\n\t\t\tcause: error,\n\t\t});\n\t}\n\treturn new DataSourceError(\n\t\terror instanceof Error ? error.message : 'An error occurred',\n\t\t{ code: 'INTERNAL_SERVER_ERROR', cause: error },\n\t);\n}\n",
+    "import type { Connection, Paginated } from './types';\n\n/**\n * A service's `{ data, metadata }` page as a Relay connection: each item an\n * edge, its `id` the cursor. Without `metadata`, its page info is an empty\n * last page's, even when it has items.\n */\nexport function relayPaginate<T extends { id: string }>(\n\tpage: Paginated<T>,\n): Connection<T> {\n\tconst { data: items, metadata } = page;\n\treturn {\n\t\tedges: (items ?? []).map((item) => ({ node: item, cursor: item.id })),\n\t\tpageInfo: metadata ?? {\n\t\t\tstartCursor: undefined,\n\t\t\tendCursor: undefined,\n\t\t\thasNextPage: false,\n\t\t\ttotalElements: 0,\n\t\t},\n\t};\n}\n"
   ],
-  "mappings": "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",
-  "debugId": "B0900E11F81FD7B064756E2164756E21",
+  "mappings": "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",
+  "debugId": "F26F117CA5680FFB64756E2164756E21",
   "names": []
 }

package/dist/pagination/relay.d.ts

@@ -0,0 +1,10 @@
+import type { Connection, Paginated } from './types';
+/**
+ * A service's `{ data, metadata }` page as a Relay connection: each item an
+ * edge, its `id` the cursor. Without `metadata`, its page info is an empty
+ * last page's, even when it has items.
+ */
+export declare function relayPaginate<T extends {
+    id: string;
+}>(page: Paginated<T>): Connection<T>;
+//# sourceMappingURL=relay.d.ts.map

package/dist/pagination/relay.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"relay.d.ts","sourceRoot":"","sources":["../../src/pagination/relay.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,SAAS,CAAC;AAErD;;;;GAIG;AACH,wBAAgB,aAAa,CAAC,CAAC,SAAS;IAAE,EAAE,EAAE,MAAM,CAAA;CAAE,EACrD,IAAI,EAAE,SAAS,CAAC,CAAC,CAAC,GAChB,UAAU,CAAC,CAAC,CAAC,CAWf"}

package/dist/pagination/types.d.ts

@@ -0,0 +1,25 @@
+/** A service's page, and the Relay connection a GraphQL schema serves it as. */
+export interface PageInfo {
+    /** The cursor of the first item in the result set. */
+    startCursor?: string;
+    /** The cursor of the last item in the result set. */
+    endCursor?: string;
+    /** Whether there are more items after the current page. */
+    hasNextPage: boolean;
+    /** The number of items across all pages. */
+    totalElements: number;
+}
+/** A page as the services send it. */
+export type Paginated<T> = {
+    data?: T[];
+    metadata?: PageInfo;
+};
+export type Edge<T> = {
+    node: T;
+    cursor: string;
+};
+export type Connection<T> = {
+    edges: Edge<T>[];
+    pageInfo: PageInfo;
+};
+//# sourceMappingURL=types.d.ts.map

package/dist/pagination/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/pagination/types.ts"],"names":[],"mappings":"AAAA,gFAAgF;AAChF,MAAM,WAAW,QAAQ;IACxB,sDAAsD;IACtD,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,qDAAqD;IACrD,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,2DAA2D;IAC3D,WAAW,EAAE,OAAO,CAAC;IACrB,4CAA4C;IAC5C,aAAa,EAAE,MAAM,CAAC;CACtB;AAED,sCAAsC;AACtC,MAAM,MAAM,SAAS,CAAC,CAAC,IAAI;IAC1B,IAAI,CAAC,EAAE,CAAC,EAAE,CAAC;IACX,QAAQ,CAAC,EAAE,QAAQ,CAAC;CACpB,CAAC;AAEF,MAAM,MAAM,IAAI,CAAC,CAAC,IAAI;IACrB,IAAI,EAAE,CAAC,CAAC;IACR,MAAM,EAAE,MAAM,CAAC;CACf,CAAC;AAEF,MAAM,MAAM,UAAU,CAAC,CAAC,IAAI;IAC3B,KAAK,EAAE,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC;IACjB,QAAQ,EAAE,QAAQ,CAAC;CACnB,CAAC"}

package/package.json

@@ -1,14 +1,15 @@
 {
 	"name": "@nxgt/datasource-rest",
-	"version": "1.0.3",
-	"license": "UNLICENSED",
+	"version": "3.0.0",
+	"license": "MIT",
 	"type": "module",
 	"main": "./dist/index.js",
 	"types": "./dist/index.d.ts",
 	"files": [
 		"dist",
 		"README.md",
-		"package.json"
+		"package.json",
+		"LICENSE"
 	],
 	"exports": {
 		".": {
@@ -20,7 +21,7 @@
 	},
 	"repository": {
 		"type": "git",
-		"url": "git+https://github.com/softistx/nxgt-core.git",
+		"url": "git+https://github.com/softistx/nxgt-http.git",
 		"directory": "packages/datasource-rest"
 	},
 	"publishConfig": {
@@ -29,24 +30,25 @@
 	},
 	"scripts": {
 		"build": "bun run ../../build.ts",
-		"typecheck": "tsc --noEmit"
+		"fixtures": "bun run test/generate.ts",
+		"test": "bun run fixtures && bun test src",
+		"typecheck": "bun run fixtures && tsc --noEmit"
 	},
 	"nxgt": {
 		"entrypoints": [
 			"src/index.ts"
 		]
 	},
-	"dependencies": {
-		"lodash": "^4.18.1",
-		"@nxgt/shared": "^1.0.2",
-		"@nxgt/shared-exceptions": "^1.0.2",
-		"openapi-fetch": "^0.17.0"
-	},
 	"devDependencies": {
+		"@nxgt/httpyz": "^0.1.0",
+		"@nxgt/openapi-codegen": "^0.2.0",
+		"@nxgt/openapi-httpyz": "^0.1.0",
 		"@types/bun": "^1.4.0",
-		"@types/lodash": "^4.17.24"
+		"zod": "^4.5.4"
 	},
 	"peerDependencies": {
+		"@nxgt/httpyz": "^0.1.0",
+		"@nxgt/openapi-httpyz": "^0.1.0",
 		"typescript": "^6.0.3"
 	}
 }

package/dist/helpers/error-handling.d.ts

@@ -1,3 +0,0 @@
-import { CustomException } from '@nxgt/shared-exceptions';
-export declare function errorToException(error: any, response: Response): CustomException<any>;
-//# sourceMappingURL=error-handling.d.ts.map

package/dist/helpers/error-handling.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"error-handling.d.ts","sourceRoot":"","sources":["../../src/helpers/error-handling.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAa,MAAM,yBAAyB,CAAC;AAErE,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,GAAG,EAAE,QAAQ,EAAE,QAAQ,wBAyB9D"}

package/dist/helpers/index.d.ts

@@ -1,3 +0,0 @@
-export * from './error-handling';
-export * from './pagination.utils';
-//# sourceMappingURL=index.d.ts.map

package/dist/helpers/index.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/helpers/index.ts"],"names":[],"mappings":"AAAA,cAAc,kBAAkB,CAAC;AACjC,cAAc,oBAAoB,CAAC"}

package/dist/helpers/pagination.utils.d.ts

@@ -1,5 +0,0 @@
-import type { Connection, Paginated } from '../types';
-export declare function relayPaginate<T extends {
-    id: string;
-}>(data: Paginated<T>): Connection<T>;
-//# sourceMappingURL=pagination.utils.d.ts.map

package/dist/helpers/pagination.utils.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"pagination.utils.d.ts","sourceRoot":"","sources":["../../src/helpers/pagination.utils.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,UAAU,CAAC;AAEtD,wBAAgB,aAAa,CAAC,CAAC,SAAS;IAAE,EAAE,EAAE,MAAM,CAAA;CAAE,EACrD,IAAI,EAAE,SAAS,CAAC,CAAC,CAAC,GAChB,UAAU,CAAC,CAAC,CAAC,CAcf"}

package/dist/middlewares/auth.middleware.d.ts

@@ -1,7 +0,0 @@
-import type { Middleware } from 'openapi-fetch';
-export type AuthMiddlewareOptions = {
-    token?: string | (() => Promise<string>);
-    shouldUseToken?: (request: Request) => boolean;
-};
-export declare const authMiddleware: (options: AuthMiddlewareOptions) => Middleware;
-//# sourceMappingURL=auth.middleware.d.ts.map

package/dist/middlewares/auth.middleware.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"auth.middleware.d.ts","sourceRoot":"","sources":["../../src/middlewares/auth.middleware.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAEhD,MAAM,MAAM,qBAAqB,GAAG;IACnC,KAAK,CAAC,EAAE,MAAM,GAAG,CAAC,MAAM,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC;IACzC,cAAc,CAAC,EAAE,CAAC,OAAO,EAAE,OAAO,KAAK,OAAO,CAAC;CAC/C,CAAC;AAEF,eAAO,MAAM,cAAc,GAAI,SAAS,qBAAqB,KAAG,UAa9D,CAAC"}

package/dist/middlewares/cache.middleware.d.ts

@@ -1,7 +0,0 @@
-import type { Middleware } from 'openapi-fetch';
-export type CacheMiddlewareOptions = {
-    ttl?: number;
-    shouldCachePostRequest?: (req: Request) => boolean;
-};
-export declare const cacheMiddleware: ({ ttl, shouldCachePostRequest, }?: CacheMiddlewareOptions) => Middleware;
-//# sourceMappingURL=cache.middleware.d.ts.map

package/dist/middlewares/cache.middleware.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"cache.middleware.d.ts","sourceRoot":"","sources":["../../src/middlewares/cache.middleware.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAKhD,MAAM,MAAM,sBAAsB,GAAG;IACpC,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,sBAAsB,CAAC,EAAE,CAAC,GAAG,EAAE,OAAO,KAAK,OAAO,CAAC;CACnD,CAAC;AAEF,eAAO,MAAM,eAAe,GAAI,mCAG7B,sBAA2B,KAAG,UAqB/B,CAAC"}

package/dist/middlewares/index.d.ts

@@ -1,3 +0,0 @@
-export * from './auth.middleware';
-export * from './cache.middleware';
-//# sourceMappingURL=index.d.ts.map

package/dist/middlewares/index.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/middlewares/index.ts"],"names":[],"mappings":"AAAA,cAAc,mBAAmB,CAAC;AAClC,cAAc,oBAAoB,CAAC"}

package/dist/rest-datasource.d.ts

@@ -1,21 +0,0 @@
-import type { Client, ClientMethod } from 'openapi-fetch';
-import { type AuthMiddlewareOptions, type CacheMiddlewareOptions } from './middlewares';
-import type { MediaType } from './types';
-export type RESTDataSourceOptions<Paths extends {}, Media extends MediaType = MediaType> = {
-    client: Client<Paths, Media>;
-    cacheOptions?: CacheMiddlewareOptions;
-    authOptions?: AuthMiddlewareOptions;
-};
-export declare class RESTDataSource<Paths extends {}, Media extends MediaType = MediaType> {
-    protected client: Client<Paths, Media>;
-    get: ClientMethod<Paths, 'get', Media>;
-    post: ClientMethod<Paths, 'post', Media>;
-    put: ClientMethod<Paths, 'put', Media>;
-    patch: ClientMethod<Paths, 'patch', Media>;
-    delete: ClientMethod<Paths, 'delete', Media>;
-    head: ClientMethod<Paths, 'head', Media>;
-    options: ClientMethod<Paths, 'options', Media>;
-    trace: ClientMethod<Paths, 'trace', Media>;
-    constructor(options: RESTDataSourceOptions<Paths, Media>);
-}
-//# sourceMappingURL=rest-datasource.d.ts.map

package/dist/rest-datasource.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"rest-datasource.d.ts","sourceRoot":"","sources":["../src/rest-datasource.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AAC1D,OAAO,EACN,KAAK,qBAAqB,EAE1B,KAAK,sBAAsB,EAE3B,MAAM,eAAe,CAAC;AACvB,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,SAAS,CAAC;AAEzC,MAAM,MAAM,qBAAqB,CAChC,KAAK,SAAS,EAAE,EAChB,KAAK,SAAS,SAAS,GAAG,SAAS,IAChC;IACH,MAAM,EAAE,MAAM,CAAC,KAAK,EAAE,KAAK,CAAC,CAAC;IAC7B,YAAY,CAAC,EAAE,sBAAsB,CAAC;IACtC,WAAW,CAAC,EAAE,qBAAqB,CAAC;CACpC,CAAC;AAEF,qBAAa,cAAc,CAC1B,KAAK,SAAS,EAAE,EAChB,KAAK,SAAS,SAAS,GAAG,SAAS;IAEnC,SAAS,CAAC,MAAM,EAAE,MAAM,CAAC,KAAK,EAAE,KAAK,CAAC,CAAC;IAEvC,GAAG,EAAE,YAAY,CAAC,KAAK,EAAE,KAAK,EAAE,KAAK,CAAC,CAAC;IACvC,IAAI,EAAE,YAAY,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,CAAC,CAAC;IACzC,GAAG,EAAE,YAAY,CAAC,KAAK,EAAE,KAAK,EAAE,KAAK,CAAC,CAAC;IACvC,KAAK,EAAE,YAAY,CAAC,KAAK,EAAE,OAAO,EAAE,KAAK,CAAC,CAAC;IAC3C,MAAM,EAAE,YAAY,CAAC,KAAK,EAAE,QAAQ,EAAE,KAAK,CAAC,CAAC;IAC7C,IAAI,EAAE,YAAY,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,CAAC,CAAC;IACzC,OAAO,EAAE,YAAY,CAAC,KAAK,EAAE,SAAS,EAAE,KAAK,CAAC,CAAC;IAC/C,KAAK,EAAE,YAAY,CAAC,KAAK,EAAE,OAAO,EAAE,KAAK,CAAC,CAAC;gBAE/B,OAAO,EAAE,qBAAqB,CAAC,KAAK,EAAE,KAAK,CAAC;CAexD"}

package/dist/types.d.ts

@@ -1,39 +0,0 @@
-export type MediaType = `${string}/${string}`;
-export type UpperHttpMethod = 'GET' | 'PUT' | 'POST' | 'DELETE' | 'OPTIONS' | 'HEAD' | 'PATCH' | 'TRACE';
-export type HttpMethod = 'get' | 'put' | 'post' | 'delete' | 'options' | 'head' | 'patch' | 'trace';
-export type ErrorResponse = {
-    status?: number;
-    message?: string;
-    debugMessage?: string;
-};
-export interface PageInfo {
-    /**
-     * The cursor of the first item in the result set.
-     */
-    startCursor?: string;
-    /**
-     * The cursor of the last item in the result set.
-     */
-    endCursor?: string;
-    /**
-     * Indicates whether there are more items after the current page.
-     */
-    hasNextPage: boolean;
-    /**
-     * The total number of elements across all pages.
-     */
-    totalElements: number;
-}
-export type Paginated<T> = {
-    data?: T[];
-    metadata?: PageInfo;
-};
-export type Edge<T> = {
-    node: T;
-    cursor: string;
-};
-export type Connection<T> = {
-    edges: Edge<T>[];
-    pageInfo: PageInfo;
-};
-//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,SAAS,GAAG,GAAG,MAAM,IAAI,MAAM,EAAE,CAAC;AAE9C,MAAM,MAAM,eAAe,GACxB,KAAK,GACL,KAAK,GACL,MAAM,GACN,QAAQ,GACR,SAAS,GACT,MAAM,GACN,OAAO,GACP,OAAO,CAAC;AAEX,MAAM,MAAM,UAAU,GACnB,KAAK,GACL,KAAK,GACL,MAAM,GACN,QAAQ,GACR,SAAS,GACT,MAAM,GACN,OAAO,GACP,OAAO,CAAC;AAEX,MAAM,MAAM,aAAa,GAAG;IAC3B,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,YAAY,CAAC,EAAE,MAAM,CAAC;CACtB,CAAC;AAEF,MAAM,WAAW,QAAQ;IACxB;;OAEG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC;IAErB;;OAEG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;IAEnB;;OAEG;IACH,WAAW,EAAE,OAAO,CAAC;IAErB;;OAEG;IACH,aAAa,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,MAAM,SAAS,CAAC,CAAC,IAAI;IAC1B,IAAI,CAAC,EAAE,CAAC,EAAE,CAAC;IACX,QAAQ,CAAC,EAAE,QAAQ,CAAC;CACpB,CAAC;AAEF,MAAM,MAAM,IAAI,CAAC,CAAC,IAAI;IACrB,IAAI,EAAE,CAAC,CAAC;IACR,MAAM,EAAE,MAAM,CAAC;CACf,CAAC;AAEF,MAAM,MAAM,UAAU,CAAC,CAAC,IAAI;IAC3B,KAAK,EAAE,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC;IACjB,QAAQ,EAAE,QAAQ,CAAC;CACnB,CAAC"}