@alistt69/create-api 0.2.11 → 0.4.0

package/README.md

@@ -1,13 +1,13 @@
 <table width="100%">
   <tr>
     <td width="190" align="center">
-      <img src="assets/alistt69-packages-logo.svg" alt="Logo" width="170" height="170" style="margin-top: 50px;" />
+      <img src="assets/alistt69-packages-logo.svg" alt="@alistt69 packages logo" width="160" height="160" />
     </td>
     <td>
       <h1>@alistt69/create-api</h1>
 
 > **One helper. No extra.**  
-> A lightweight createApi inspired by **RTKQ** — with query, lazy query and mutation hooks, built-in cache utilities, stale data handling and a tiny, focused API.
+> A lightweight createApi inspired by **RTKQ** — with query, lazy query and mutation hooks & endpoint controllers, built-in cache utilities, stale data handling and a tiny, focused API.
 
 [![npm version](https://img.shields.io/npm/v/@alistt69/create-api.svg)](https://www.npmjs.com/package/@alistt69/create-api)
 [![Node.js Version](https://img.shields.io/badge/node-%3E%3D18-brightgreen)](https://nodejs.org/)
@@ -19,155 +19,382 @@
   </tr>
 </table>
 
-## 🚀 Demo
+---
 
-_[Live Demo](https://create-api-demo.vercel.app/)_
-<br />
-_Sandbox is coming soon..._
+<p align="center">
+  <a href="#install">Install</a>
+  &middot; <a href="#quick-start">Quick Start</a>
+  &middot; <a href="#the-shape">The Shape</a>
+  &middot; <a href="#cache">Cache</a>
+  &middot; <a href="#imperative-api">Imperative API</a>
+  &middot; <a href="#controller">Controller</a>
+</p>
 
-## ✨ Overview
+---
 
-`@alistt69/create-api` is a lightweight [RTK Query-inspired](https://redux-toolkit.js.org/rtk-query/overview) helper for React apps that need a clean createApi experience without Redux.
+## Why this exists
 
-It provides query, lazy query and mutation hooks, cache helpers and stale data support in a compact API designed for everyday app needs.
+`@alistt69/create-api` is for React projects that like the ergonomics of
+RTK Query, but do not want to introduce Redux just to fetch data.
 
-## 🔧  What’s inside
+It gives you a compact `createApi` workflow:
 
-| Feature              | Purpose                              |
-| -------------------- | ------------------------------------ |
-| Query hooks          | Fetch data with generated hooks      |
-| Lazy query hooks     | Trigger queries manually when needed |
-| Mutation hooks       | Handle writes with generated hooks   |
-| fetchBaseQuery       | Ready-to-use HTTP baseQuery built on fetch |
-| Cache utils          | Read and patch cached data manually  |
-| Stale time support   | Reuse cached data before refetching  |
-| Keep unused data for | Control cache lifetime after unmount |
-
-## 🎯 Why use it?
-
-This package is specified for projects with no Redux. 
+```txt
+define endpoints -> get typed hooks -> read/write cache -> refetch when stale
+```
 
-It gives you a RTKQ-similar API model and developer experience, while staying smaller, simpler and focused on the most common data-fetching needs.
+Use it when you want:
 
-Do whatever you want and however you want with:
-* generated hooks
-* predictable cache behavior
-* simple manual cache updates
-* a focused API without a larger state layer
-* a built-in `fetchBaseQuery` for managing your HTTP requests
+| You need | You get |
+| --- | --- |
+| Generated React hooks | `useGetPostQuery`, `useLazyGetPostQuery`, `useUpdatePostMutation` |
+| A small HTTP layer | `fetchBaseQuery`, built on native `fetch` |
+| Cache reads and patches | `getQueryData`, `setQueryData`, `updateQueryData` |
+| Stale data handling | `staleTime`, `keepUnusedDataFor`, `refetchOnMount` |
+| Manual orchestration | `api.endpoints.*.initiate`, `select`, `subscribe` |
+| Store-based usage | `createController` from the controller subpath |
 
-## 📦 Requirements
-* Node.js 18 or higher
-* React 16.8 or higher
+## Install
 
-## 🔥 Install
 ```bash
 npm i @alistt69/create-api
 ```
 
-## ⚡ Quick example
-```typescript jsx
+Requirements:
+
+| Runtime | Version |
+| --- | --- |
+| Node.js | `>=18` |
+| React | `>=16.8` |
+
+## Quick Start
+
+Create an API once:
+
+```tsx
 import { createApi, fetchBaseQuery } from '@alistt69/create-api';
 
 const api = createApi({
-    baseQuery: fetchBaseQuery({
-        baseUrl: 'https://example.com/api',
+  baseQuery: fetchBaseQuery({
+    baseUrl: 'https://example.com/api',
+  }),
+
+  endpoints: (builder) => ({
+    getPost: builder.query({
+      query: (id: string) => ({
+        url: `/posts/${id}`,
+      }),
     }),
 
-    endpoints: (builder) => ({
-        getPost: builder.query({
-            query: (id) => ({
-                url: `/posts/${id}`,
-            }),
-        }),
-
-        updatePost: builder.mutation({
-            query: ({ id, title }) => ({
-                url: `/posts/${id}`,
-                method: 'PATCH',
-                body: { title },
-            }),
-        }),
+    updatePost: builder.mutation({
+      query: ({ id, title }: { id: string; title: string }) => ({
+        url: `/posts/${id}`,
+        method: 'PATCH',
+        body: { title },
+      }),
     }),
+  }),
 });
 ```
 
-## 🛠️ Usage
-```typescript jsx
+Then use the generated hooks:
+
+```tsx
 function Post() {
-  const { data, isLoading } = api.useGetPostQuery('1');
-  const [updatePost] = api.useUpdatePostMutation();
+  const { data, isLoading, refetch } = api.useGetPostQuery('1');
+  const [updatePost, updateState] = api.useUpdatePostMutation();
 
-  if (isLoading) return <div>Loading...</div>;
+  if (isLoading) {
+    return <div>Loading...</div>;
+  }
 
   return (
-    <button onClick={() => updatePost({ id: '1', title: 'Updated' })}>
-      {data?.title}
-    </button>
+    <section>
+      <h2>{data?.title}</h2>
+
+      <button
+        disabled={updateState.isLoading}
+        onClick={() => updatePost({ id: '1', title: 'Updated' })}
+      >
+        Update
+      </button>
+
+      <button onClick={() => refetch()}>
+        Refetch
+      </button>
+    </section>
   );
 }
 ```
 
-## 🌐 fetchBaseQuery
+## The Shape
+
+The package is intentionally small, but the surface area covers the core
+data-fetching loop.
+
+### Query hooks
+
+```tsx
+const result = api.useGetPostQuery('1', {
+  enabled: true,
+  refetchOnMount: true,
+});
+```
+
+Query state includes:
+
+| Field | Meaning |
+| --- | --- |
+| `data` | Last successful value |
+| `error` | Last failed value |
+| `status` | `uninitialized`, `pending`, `fulfilled` or `rejected` |
+| `isLoading` | First request is in progress |
+| `isFetching` | Any request is in progress, including background refetch |
+| `isSuccess` | Last known state is successful |
+| `isError` | Last known state is failed |
+| `fulfilledAt` | Timestamp of the last fulfilled request |
+| `requestId` | Active or last request id |
+
+### Lazy query hooks
+
+```tsx
+const [loadPost, post] = api.useLazyGetPostQuery();
+
+await loadPost('1');
+
+post.refetch();
+```
+
+Lazy queries are useful when the request should start from a user action,
+a modal opening, a route transition or another explicit event.
 
-`fetchBaseQuery` is a small ready-to-use `baseQuery` built on top of the native `fetch` API.
+### Mutation hooks
 
-It supports:
-- `baseUrl`
-- `params`
-- `headers`
-- `prepareHeaders`
-- `timeout`
-- `responseHandler`
-- `validateStatus`
-- `fetchFn`
+```tsx
+const [updatePost, updateState] = api.useUpdatePostMutation();
+
+await updatePost({ id: '1', title: 'Updated' });
+
+updateState.reset();
+```
 
-### Example
+Mutation state tracks the latest trigger. This keeps UI behavior predictable
+when several mutation calls overlap.
+
+## `fetchBaseQuery`
+
+`fetchBaseQuery` is a ready-to-use `baseQuery` built on top of native `fetch`.
+It handles URLs, params, JSON bodies, headers, timeouts and response parsing.
 
 ```tsx
 import { createApi, fetchBaseQuery } from '@alistt69/create-api';
 
 const api = createApi({
-    baseQuery: fetchBaseQuery({
-        baseUrl: 'https://example.com/api',
-        prepareHeaders: (headers) => {
-            headers.set('authorization', 'Bearer token');
-            return headers;
-        },
-    }),
-    endpoints: (builder) => ({
-        getTickets: builder.query({
-            query: ({ page }) => ({
-                url: '/tickets',
-                params: { page },
-            }),
-        }),
+  baseQuery: fetchBaseQuery({
+    baseUrl: 'https://example.com/api',
+    timeout: 10_000,
+    prepareHeaders: (headers) => {
+      headers.set('authorization', 'Bearer token');
+      return headers;
+    },
+  }),
+
+  endpoints: (builder) => ({
+    getTickets: builder.query({
+      query: ({ page }: { page: number }) => ({
+        url: '/tickets',
+        params: { page },
+      }),
     }),
+  }),
 });
 ```
 
-### Blob / custom response handling
-```javascript
-downloadFile: builder.query({
-    query: () => ({
-        url: '/report',
-        responseHandler: (response) => response.blob(),
+Supported options:
+
+| Option | Where | Purpose |
+| --- | --- | --- |
+| `baseUrl` | base query | Prefix all request URLs |
+| `headers` | request | Add request-specific headers |
+| `prepareHeaders` | base query | Modify headers before every request |
+| `params` | request | Append query params |
+| `paramsSerializer` | base query | Customize query string serialization |
+| `body` | request | Send JSON, `FormData`, `Blob`, `URLSearchParams` or another fetch body |
+| `timeout` | both | Abort slow requests |
+| `responseHandler` | both | Parse as `json`, `text`, `content-type` or custom handler |
+| `validateStatus` | both | Decide whether a response is success |
+| `fetchFn` | base query | Use a custom fetch implementation |
+
+Custom response handling:
+
+```tsx
+downloadReport: builder.query({
+  query: () => ({
+    url: '/report',
+    responseHandler: (response) => response.blob(),
+  }),
+});
+```
+
+## Cache
+
+Queries are cached by endpoint name and serialized argument.
+
+```tsx
+const api = createApi({
+  baseQuery,
+  endpoints: (builder) => ({
+    getTicketById: builder.query({
+      query: (id: string) => ({ url: `/tickets/${id}` }),
+      serializeArgs: (id) => id,
+      staleTime: 2_000,
+      keepUnusedDataFor: 10_000,
     }),
-}),
+  }),
+});
 ```
 
-## ⚙️ Cache utils
-``` typescript
+Cache controls:
+
+| Option | Behavior |
+| --- | --- |
+| `serializeArgs` | Builds the cache key for an endpoint argument |
+| `staleTime` | Keeps fulfilled data fresh for automatic mount behavior |
+| `keepUnusedDataFor` | Keeps unused cache alive after the last subscriber leaves |
+| `refetchOnMount` | Controls whether cached data may refetch on mount |
+| `enabled` | Disables automatic query execution while keeping manual `refetch` available |
+
+Manual cache updates:
+
+```tsx
 api.util.getQueryData('getPost', '1');
-api.util.setQueryData('getPost', '1', { id: '1', title: 'Local title' });
+
+api.util.setQueryData('getPost', '1', {
+  id: '1',
+  title: 'Local title',
+});
+
 api.util.updateQueryData('getPost', '1', (prev) => ({
-    ...prev,
-    title: 'Patched title',
+  ...prev,
+  title: 'Patched title',
 }));
 ```
 
-## 📄 License
+### Invalidation
+
+Use endpoint-level invalidation for broad refetching:
+
+```tsx
+editTicket: builder.mutation({
+  query: ({ id, title }) => ({
+    url: `/tickets/${id}`,
+    method: 'PATCH',
+    body: { title },
+  }),
+  invalidates: ['getTickets'],
+});
+```
+
+Use tag invalidation when you want to target specific cached records:
+
+```tsx
+getTicketById: builder.query({
+  query: (id) => ({ url: `/tickets/${id}` }),
+  providesTags: (_result, id) => [`Ticket/${id}`],
+}),
+
+editTicket: builder.mutation({
+  query: ({ id, title }) => ({
+    url: `/tickets/${id}`,
+    method: 'PATCH',
+    body: { title },
+  }),
+  invalidatesTags: (_result, arg) => [`Ticket/${arg.id}`],
+});
+```
+
+## Imperative API
+
+Every endpoint also exposes a small imperative API. It is useful when a query
+lifecycle should live outside React components.
+
+```tsx
+const request = api.endpoints.getPost.initiate('1');
+
+const data = await request.unwrap();
+
+await request.refetch();
+
+request.unsubscribe();
+request.abort();
+```
+
+You can also inspect query state directly:
+
+```tsx
+const state = api.endpoints.getPost.select('1');
+```
+
+And trigger mutations:
+
+```tsx
+const mutation = api.endpoints.updatePost.initiate({
+  id: '1',
+  title: 'Updated',
+});
+
+await mutation.unwrap();
+
+mutation.abort();
+```
+
+## Controller
+
+For store-based usage, import `createController` from the controller subpath:
+
+```tsx
+import { createController } from '@alistt69/create-api/controller';
+
+class TicketStore {
+  private ticket = createController(api.endpoints.getTicketById);
+  private editTicket = createController(api.endpoints.editTicket);
+
+  load(id: string) {
+    return this.ticket.run(id);
+  }
+
+  save(id: string, title: string) {
+    return this.editTicket.run({ id, title });
+  }
+
+  get ticketData() {
+    return this.ticket.state.data;
+  }
+
+  get isLoadingTicket() {
+    return this.ticket.state.isLoading;
+  }
+
+  get isSavingTicket() {
+    return this.editTicket.state.isLoading;
+  }
+
+  destroy() {
+    this.ticket.dispose();
+    this.editTicket.dispose();
+  }
+}
+```
+
+The controller keeps endpoint state outside React, subscribes to cache updates,
+and releases its subscription with `dispose()`.
+
+## Demo
+
+[Live demo](https://create-api-demo.vercel.app/)
+
+Sandbox is coming soon.
 
-MIT — free and open for everyone.
+## License
 
-_See [LICENSE](./LICENSE)._
+MIT. See [LICENSE](./LICENSE).

package/dist/controller.d.ts

@@ -0,0 +1,3 @@
+export { createController } from './lib/createController.js';
+export type { ApiEndpointMutation, ApiEndpointQuery, MutationController, QueryController, } from './model/types.js';
+//# sourceMappingURL=controller.d.ts.map

package/dist/controller.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"controller.d.ts","sourceRoot":"","sources":["../src/controller.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,MAAM,2BAA2B,CAAC;AAC7D,YAAY,EACR,mBAAmB,EACnB,gBAAgB,EAChB,kBAAkB,EAClB,eAAe,GAClB,MAAM,kBAAkB,CAAC"}

package/dist/controller.js

@@ -0,0 +1,2 @@
+export { createController } from './lib/createController.js';
+//# sourceMappingURL=controller.js.map

package/dist/controller.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"controller.js","sourceRoot":"","sources":["../src/controller.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,MAAM,2BAA2B,CAAC"}

package/dist/index.d.ts

@@ -1,4 +1,4 @@
-import { createApi } from './lib/createApi.js';
-import { fetchBaseQuery } from './lib/fetchBaseQuery.js';
-export { createApi, fetchBaseQuery };
+export { createApi } from './lib/createApi.js';
+export { fetchBaseQuery } from './lib/fetchBaseQuery.js';
+export type { BaseQueryFn, BaseQueryResult, FetchBaseQueryArgs, FetchBaseQueryError, FetchBaseQueryMeta, FetchBaseQueryOptions, InferQueryState, QueryHookOptions, QueryInitiateResult, TagDescription, } from './model/types.js';
 //# 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,OAAO,EAAE,SAAS,EAAE,MAAM,oBAAoB,CAAC;AAC/C,OAAO,EAAE,cAAc,EAAE,MAAM,yBAAyB,CAAC;AAEzD,OAAO,EAAE,SAAS,EAAE,cAAc,EAAE,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,oBAAoB,CAAC;AAC/C,OAAO,EAAE,cAAc,EAAE,MAAM,yBAAyB,CAAC;AACzD,YAAY,EACR,WAAW,EACX,eAAe,EACf,kBAAkB,EAClB,mBAAmB,EACnB,kBAAkB,EAClB,qBAAqB,EACrB,eAAe,EACf,gBAAgB,EAChB,mBAAmB,EACnB,cAAc,GACjB,MAAM,kBAAkB,CAAC"}

package/dist/index.js

@@ -1,4 +1,3 @@
-import { createApi } from './lib/createApi.js';
-import { fetchBaseQuery } from './lib/fetchBaseQuery.js';
-export { createApi, fetchBaseQuery };
+export { createApi } from './lib/createApi.js';
+export { fetchBaseQuery } from './lib/fetchBaseQuery.js';
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,oBAAoB,CAAC;AAC/C,OAAO,EAAE,cAAc,EAAE,MAAM,yBAAyB,CAAC;AAEzD,OAAO,EAAE,SAAS,EAAE,cAAc,EAAE,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,oBAAoB,CAAC;AAC/C,OAAO,EAAE,cAAc,EAAE,MAAM,yBAAyB,CAAC"}

package/dist/lib/createApi.d.ts

@@ -1,6 +1,6 @@
 import { mutation } from '../model/mutation.js';
 import { query } from '../model/query.js';
-import { BaseQueryFn, CreateApiResult, GeneralDefinition } from '../model/types.js';
+import { type BaseQueryFn, type CreateApiResult, type GeneralDefinition } from '../model/types.js';
 export interface BaseQueryArgs {
     url: string;
     body?: unknown;

package/dist/lib/createApi.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"createApi.d.ts","sourceRoot":"","sources":["../../src/lib/createApi.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,sBAAsB,CAAC;AAChD,OAAO,EAAE,KAAK,EAAE,MAAM,mBAAmB,CAAC;AAQ1C,OAAO,EAAE,WAAW,EAAE,eAAe,EAAiB,iBAAiB,EAAE,MAAM,mBAAmB,CAAC;AAOnG,MAAM,WAAW,aAAa;IAC1B,GAAG,EAAE,MAAM,CAAC;IACZ,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,WAAW,CAAC;IACrB,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACpC;AAED,UAAU,eAAe,CAAC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,iBAAiB,CAAC;IACjE,SAAS,EAAE,WAAW,CAAC;IACvB,SAAS,EAAE,CAAC,OAAO,EAAE;QAAE,KAAK,EAAE,OAAO,KAAK,CAAC;QAAC,QAAQ,EAAE,OAAO,QAAQ,CAAA;KAAE,KAAK,CAAC,CAAC;CACjF;AAED,wBAAgB,SAAS,CAAC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,iBAAiB,CAAC,EAAE,EACnE,SAAS,EACT,SAAS,GACZ,EAAE,eAAe,CAAC,CAAC,CAAC,GAAG,eAAe,CAAC,CAAC,CAAC,CAgDzC"}
+{"version":3,"file":"createApi.d.ts","sourceRoot":"","sources":["../../src/lib/createApi.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,sBAAsB,CAAC;AAChD,OAAO,EAAE,KAAK,EAAE,MAAM,mBAAmB,CAAC;AAY1C,OAAO,EAAE,KAAK,WAAW,EAAE,KAAK,eAAe,EAAsB,KAAK,iBAAiB,EAAE,MAAM,mBAAmB,CAAC;AASvH,MAAM,WAAW,aAAa;IAC1B,GAAG,EAAE,MAAM,CAAC;IACZ,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,WAAW,CAAC;IACrB,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACpC;AAED,UAAU,eAAe,CAAC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,iBAAiB,CAAC;IACjE,SAAS,EAAE,WAAW,CAAC;IACvB,SAAS,EAAE,CAAC,OAAO,EAAE;QAAE,KAAK,EAAE,OAAO,KAAK,CAAC;QAAC,QAAQ,EAAE,OAAO,QAAQ,CAAA;KAAE,KAAK,CAAC,CAAC;CACjF;AAED,wBAAgB,SAAS,CAAC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,iBAAiB,CAAC,EAAE,EACnE,SAAS,EACT,SAAS,GACZ,EAAE,eAAe,CAAC,CAAC,CAAC,GAAG,eAAe,CAAC,CAAC,CAAC,CAwEzC"}

package/dist/lib/createApi.js

@@ -1,15 +1,18 @@
 import { mutation } from '../model/mutation.js';
 import { query } from '../model/query.js';
-import { getQueryData, setQueryData, updateQueryData, setQueryTagResolver, setQueryKeySerializer, } from '../model/queryStore.js';
+import { getQueryData, getQueryKeyByEndpointArg, invalidateTags, selectQueryState, setQueryData, setQueryKeySerializer, setQueryTagResolver, subscribeToQuery, updateQueryData, } from '../model/queryStore.js';
 import { getHookName } from './getHookName.js';
+import { initiateQuery } from './initiateQuery.js';
 import { makeLazyQueryHook } from './makeLazyQueryHook.js';
 import { makeMutationHook } from './makeMutationHook.js';
 import { makeQueryHook } from './makeQueryHook.js';
 import { typedObjectKeys } from './typedObjectKeys.js';
+import { initiateMutation } from './initiateMutation.js';
 export function createApi({ endpoints, baseQuery, }) {
     const transformedEndpoints = endpoints({ query, mutation });
     const keys = typedObjectKeys(transformedEndpoints);
     const apiResult = {};
+    const localEndpoints = {};
     keys.forEach((endpointName) => {
         const definition = transformedEndpoints[endpointName];
         const makeHookProps = {
@@ -17,6 +20,22 @@ export function createApi({ endpoints, baseQuery, }) {
             endpointName,
             ...definition,
         };
+        if (definition.type === 'query') {
+            localEndpoints[endpointName] = {
+                name: endpointName,
+                type: definition.type,
+                select: (arg) => selectQueryState(endpointName, arg),
+                initiate: (arg) => initiateQuery(makeHookProps, arg),
+                subscribe: (arg, listener) => subscribeToQuery(getQueryKeyByEndpointArg(endpointName, arg), listener, definition.keepUnusedDataFor ?? 0),
+            };
+        }
+        if (definition.type === 'mutation') {
+            localEndpoints[endpointName] = {
+                name: endpointName,
+                type: definition.type,
+                initiate: (arg) => initiateMutation(makeHookProps, arg),
+            };
+        }
         if (definition.type === 'query') {
             setQueryKeySerializer(endpointName, (arg) => definition.serializeArgs
                 ? definition.serializeArgs(arg)
@@ -33,7 +52,8 @@ export function createApi({ endpoints, baseQuery, }) {
         getQueryData,
         setQueryData,
         updateQueryData,
+        invalidateTags,
     };
-    return { ...apiResult, util };
+    return { ...apiResult, endpoints: localEndpoints, util };
 }
 //# sourceMappingURL=createApi.js.map

package/dist/lib/createApi.js.map

@@ -1 +1 @@
-{"version":3,"file":"createApi.js","sourceRoot":"","sources":["../../src/lib/createApi.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,sBAAsB,CAAC;AAChD,OAAO,EAAE,KAAK,EAAE,MAAM,mBAAmB,CAAC;AAC1C,OAAO,EACH,YAAY,EACZ,YAAY,EACZ,eAAe,EACf,mBAAmB,EACnB,qBAAqB,GACxB,MAAM,wBAAwB,CAAC;AAEhC,OAAO,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAC/C,OAAO,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAC;AAC3D,OAAO,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AACzD,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AACnD,OAAO,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AAevD,MAAM,UAAU,SAAS,CAA8C,EACnE,SAAS,EACT,SAAS,GACQ;IACjB,MAAM,oBAAoB,GAAG,SAAS,CAAC,EAAE,KAAK,EAAE,QAAQ,EAAE,CAAC,CAAC;IAE5D,MAAM,IAAI,GAAG,eAAe,CAAC,oBAAoB,CAAC,CAAC;IACnD,MAAM,SAAS,GAA4B,EAAE,CAAC;IAE9C,IAAI,CAAC,OAAO,CAAC,CAAC,YAAY,EAAE,EAAE;QAC1B,MAAM,UAAU,GAAG,oBAAoB,CAAC,YAAY,CAAC,CAAC;QAEtD,MAAM,aAAa,GAAG;YAClB,SAAS;YACT,YAAY;YACZ,GAAG,UAAU;SAChB,CAAC;QAEF,IAAI,UAAU,CAAC,IAAI,KAAK,OAAO,EAAE,CAAC;YAC9B,qBAAqB,CACjB,YAAY,EACZ,CAAC,GAAG,EAAE,EAAE,CAAC,UAAU,CAAC,aAAa;gBAC7B,CAAC,CAAC,UAAU,CAAC,aAAa,CAAC,GAAG,CAAC;gBAC/B,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,CAC5B,CAAC;YAEF,mBAAmB,CACf,YAAY,EACZ,UAAU,CAAC,YAAY;gBACnB,CAAC,CAAC,CAAC,IAAI,EAAE,GAAG,EAAE,EAAE,CAAC,UAAU,CAAC,YAAY,EAAE,CAAC,IAAI,EAAE,GAAG,CAAC,IAAI,EAAE;gBAC3D,CAAC,CAAC,SAAS,CAClB,CAAC;YAEF,SAAS,CAAC,WAAW,CAAC,YAAY,EAAE,UAAU,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC,GAAG,iBAAiB,CAAC,aAAa,CAAC,CAAC;QACrG,CAAC;QAED,SAAS,CAAC,WAAW,CAAC,YAAY,EAAE,UAAU,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,GAAG,UAAU,CAAC,IAAI,KAAK,OAAO;YACnF,CAAC,CAAC,CACE,aAAa,CAAC,aAAa,CAAC,CAC/B,CAAC,CAAC,CAAC,CACA,gBAAgB,CAAC,aAAa,CAAC,CAClC,CAAC;IACV,CAAC,CAAC,CAAC;IAEH,MAAM,IAAI,GAAkB;QACxB,YAAY;QACZ,YAAY;QACZ,eAAe;KAClB,CAAC;IAEF,OAAO,EAAE,GAAG,SAAS,EAAE,IAAI,EAAwB,CAAC;AACxD,CAAC"}
+{"version":3,"file":"createApi.js","sourceRoot":"","sources":["../../src/lib/createApi.ts"],"names":[],"mappings":"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"}

package/dist/lib/createController.d.ts

@@ -0,0 +1,4 @@
+import { type ApiEndpointMutation, type ApiEndpointQuery, type MutationController, type QueryController } from '../model/types.js';
+export declare function createController<R, A>(endpoint: ApiEndpointQuery<R, A>): QueryController<R, A>;
+export declare function createController<R, A>(endpoint: ApiEndpointMutation<R, A>): MutationController<R, A>;
+//# sourceMappingURL=createController.d.ts.map

package/dist/lib/createController.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"createController.d.ts","sourceRoot":"","sources":["../../src/lib/createController.ts"],"names":[],"mappings":"AACA,OAAO,EACH,KAAK,mBAAmB,EACxB,KAAK,gBAAgB,EAGrB,KAAK,kBAAkB,EAEvB,KAAK,eAAe,EAEvB,MAAM,mBAAmB,CAAC;AAE3B,wBAAgB,gBAAgB,CAAC,CAAC,EAAE,CAAC,EACjC,QAAQ,EAAE,gBAAgB,CAAC,CAAC,EAAE,CAAC,CAAC,GACjC,eAAe,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;AAEzB,wBAAgB,gBAAgB,CAAC,CAAC,EAAE,CAAC,EACjC,QAAQ,EAAE,mBAAmB,CAAC,CAAC,EAAE,CAAC,CAAC,GACpC,kBAAkB,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC"}