tempest-react-sdk 0.23.0 → 0.25.0

package/dist/data/create-data-provider.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"create-data-provider.cjs","sources":["../../src/data/create-data-provider.ts"],"sourcesContent":["import type { ApiClient, RequestOptions } from \"@/http/types\";\nimport type { OffsetPage } from \"@/query/pagination\";\n\n/** Query-param values accepted by the API client for a list request. */\ntype ParamValue = string | number | boolean | undefined | null;\n\n/** Filters passed to {@link DataProvider.getList}, spread verbatim into the query string. */\nexport type DataFilters = Record<string, ParamValue>;\n\n/** Parameters for a paginated, sorted, filtered list request. */\nexport interface GetListParams {\n    /** Offset pagination — 1-based `page` and `pageSize`. */\n    pagination?: { page?: number; pageSize?: number };\n    /** Single-field sort. `order` defaults to `\"asc\"`. */\n    sort?: { field: string; order?: \"asc\" | \"desc\" };\n    /** Arbitrary filter query params, spread onto the request. */\n    filters?: DataFilters;\n}\n\n/**\n * Refine-style data provider over the Tempest FastAPI SDK CRUD/pagination\n * conventions. Implementations are stateless wrappers around an {@link ApiClient}.\n */\nexport interface DataProvider {\n    /**\n     * Fetch a paginated list of a resource.\n     *\n     * @param resource - The resource name (e.g. `\"users\"`).\n     * @param params - Pagination, sort and filter parameters.\n     * @returns The offset-paginated envelope.\n     */\n    getList<T>(resource: string, params?: GetListParams): Promise<OffsetPage<T>>;\n    /**\n     * Fetch a single record by id.\n     *\n     * @param resource - The resource name.\n     * @param id - The record id.\n     * @returns The record.\n     */\n    getOne<T>(resource: string, id: string | number): Promise<T>;\n    /**\n     * Fetch many records by id (default: parallel {@link DataProvider.getOne}).\n     *\n     * @param resource - The resource name.\n     * @param ids - The record ids.\n     * @returns The records, in the same order as `ids`.\n     */\n    getMany<T>(resource: string, ids: (string | number)[]): Promise<T[]>;\n    /**\n     * Create a record.\n     *\n     * @param resource - The resource name.\n     * @param data - The creation payload.\n     * @returns The created record.\n     */\n    create<T>(resource: string, data: unknown): Promise<T>;\n    /**\n     * Update a record (PATCH by default, PUT when configured).\n     *\n     * @param resource - The resource name.\n     * @param id - The record id.\n     * @param data - The update payload.\n     * @returns The updated record.\n     */\n    update<T>(resource: string, id: string | number, data: unknown): Promise<T>;\n    /**\n     * Delete a record by id.\n     *\n     * @param resource - The resource name.\n     * @param id - The record id.\n     * @returns The delete response (often the deleted record).\n     */\n    deleteOne<T>(resource: string, id: string | number): Promise<T>;\n}\n\n/** Options to tailor {@link createDataProvider} to a backend's conventions. */\nexport interface DataProviderOptions {\n    /** Query-param name for the page number. Default: `\"page\"`. */\n    pageParam?: string;\n    /** Query-param name for the page size. Default: `\"size\"`. */\n    sizeParam?: string;\n    /** Query-param name for the sort field. Default: `\"order_by\"`. */\n    sortFieldParam?: string;\n    /** Query-param name for the sort order. Default: `\"ascending\"`. */\n    sortOrderParam?: string;\n    /**\n     * When `true` (default), emit the sort order as a boolean\n     * (`order:\"asc\"` → `true`). When `false`, emit the literal `\"asc\"`/`\"desc\"`.\n     */\n    sortOrderAsBoolean?: boolean;\n    /** HTTP method used by {@link DataProvider.update}. Default: `\"patch\"`. */\n    updateMethod?: \"patch\" | \"put\";\n    /**\n     * Build the request path for a resource (and optional id).\n     * Default: `id == null ? \"/\" + resource : \"/\" + resource + \"/\" + id`.\n     */\n    buildPath?: (resource: string, id?: string | number) => string;\n}\n\nconst defaultBuildPath = (resource: string, id?: string | number): string =>\n    id == null ? `/${resource}` : `/${resource}/${id}`;\n\n/**\n * Create a {@link DataProvider} bound to an {@link ApiClient}.\n *\n * Maps Refine-style calls to the Tempest FastAPI SDK conventions: list →\n * `GET /{resource}?page=&size=&order_by=&ascending=&...filters`, one →\n * `GET /{resource}/{id}`, create → `POST`, update → `PATCH`/`PUT`,\n * delete → `DELETE`.\n *\n * @param client - The HTTP client created by `createApiClient`.\n * @param options - Optional overrides for param names, sort encoding,\n *   update method and path building.\n * @returns A stateless data provider.\n *\n * @example\n * const dataProvider = createDataProvider(apiClient);\n * const page = await dataProvider.getList<User>(\"users\", {\n *     pagination: { page: 1, pageSize: 20 },\n *     sort: { field: \"created_at\", order: \"desc\" },\n *     filters: { active: true },\n * });\n */\nexport function createDataProvider(\n    client: ApiClient,\n    options: DataProviderOptions = {},\n): DataProvider {\n    const {\n        pageParam = \"page\",\n        sizeParam = \"size\",\n        sortFieldParam = \"order_by\",\n        sortOrderParam = \"ascending\",\n        sortOrderAsBoolean = true,\n        updateMethod = \"patch\",\n        buildPath = defaultBuildPath,\n    } = options;\n\n    const provider: DataProvider = {\n        getList<T>(resource: string, params: GetListParams = {}): Promise<OffsetPage<T>> {\n            const { pagination, sort, filters } = params;\n            const query: Record<string, ParamValue> = {};\n\n            if (pagination?.page != null) query[pageParam] = pagination.page;\n            if (pagination?.pageSize != null) query[sizeParam] = pagination.pageSize;\n\n            if (sort?.field) {\n                const order = sort.order ?? \"asc\";\n                query[sortFieldParam] = sort.field;\n                query[sortOrderParam] = sortOrderAsBoolean ? order === \"asc\" : order;\n            }\n\n            if (filters) {\n                for (const [key, value] of Object.entries(filters)) {\n                    query[key] = value;\n                }\n            }\n\n            const requestOptions: RequestOptions = { params: query };\n            return client.get<OffsetPage<T>>(buildPath(resource), requestOptions);\n        },\n\n        getOne<T>(resource: string, id: string | number): Promise<T> {\n            return client.get<T>(buildPath(resource, id));\n        },\n\n        getMany<T>(resource: string, ids: (string | number)[]): Promise<T[]> {\n            return Promise.all(ids.map((id) => provider.getOne<T>(resource, id)));\n        },\n\n        create<T>(resource: string, data: unknown): Promise<T> {\n            return client.post<T>(buildPath(resource), { body: data });\n        },\n\n        update<T>(resource: string, id: string | number, data: unknown): Promise<T> {\n            const path = buildPath(resource, id);\n            return updateMethod === \"put\"\n                ? client.put<T>(path, { body: data })\n                : client.patch<T>(path, { body: data });\n        },\n\n        deleteOne<T>(resource: string, id: string | number): Promise<T> {\n            return client.delete<T>(buildPath(resource, id));\n        },\n    };\n\n    return provider;\n}\n"],"names":["defaultBuildPath","resource","id","createDataProvider","client","options","pageParam","sizeParam","sortFieldParam","sortOrderParam","sortOrderAsBoolean","updateMethod","buildPath","provider","params","pagination","sort","filters","query","order","key","value","requestOptions","ids","data","path"],"mappings":"gFAmGA,MAAMA,EAAmB,CAACC,EAAkBC,IACxCA,GAAM,KAAO,IAAID,CAAQ,GAAK,IAAIA,CAAQ,IAAIC,CAAE,GAuB7C,SAASC,EACZC,EACAC,EAA+B,GACnB,CACZ,KAAM,CACF,UAAAC,EAAY,OACZ,UAAAC,EAAY,OACZ,eAAAC,EAAiB,WACjB,eAAAC,EAAiB,YACjB,mBAAAC,EAAqB,GACrB,aAAAC,EAAe,QACf,UAAAC,EAAYZ,CAAA,EACZK,EAEEQ,EAAyB,CAC3B,QAAWZ,EAAkBa,EAAwB,GAA4B,CAC7E,KAAM,CAAE,WAAAC,EAAY,KAAAC,EAAM,QAAAC,CAAA,EAAYH,EAChCI,EAAoC,CAAA,EAK1C,GAHIH,GAAY,MAAQ,OAAMG,EAAMZ,CAAS,EAAIS,EAAW,MACxDA,GAAY,UAAY,OAAMG,EAAMX,CAAS,EAAIQ,EAAW,UAE5DC,GAAM,MAAO,CACb,MAAMG,EAAQH,EAAK,OAAS,MAC5BE,EAAMV,CAAc,EAAIQ,EAAK,MAC7BE,EAAMT,CAAc,EAAIC,EAAqBS,IAAU,MAAQA,CACnE,CAEA,GAAIF,EACA,SAAW,CAACG,EAAKC,CAAK,IAAK,OAAO,QAAQJ,CAAO,EAC7CC,EAAME,CAAG,EAAIC,EAIrB,MAAMC,EAAiC,CAAE,OAAQJ,CAAA,EACjD,OAAOd,EAAO,IAAmBQ,EAAUX,CAAQ,EAAGqB,CAAc,CACxE,EAEA,OAAUrB,EAAkBC,EAAiC,CACzD,OAAOE,EAAO,IAAOQ,EAAUX,EAAUC,CAAE,CAAC,CAChD,EAEA,QAAWD,EAAkBsB,EAAwC,CACjE,OAAO,QAAQ,IAAIA,EAAI,IAAKrB,GAAOW,EAAS,OAAUZ,EAAUC,CAAE,CAAC,CAAC,CACxE,EAEA,OAAUD,EAAkBuB,EAA2B,CACnD,OAAOpB,EAAO,KAAQQ,EAAUX,CAAQ,EAAG,CAAE,KAAMuB,EAAM,CAC7D,EAEA,OAAUvB,EAAkBC,EAAqBsB,EAA2B,CACxE,MAAMC,EAAOb,EAAUX,EAAUC,CAAE,EACnC,OAAOS,IAAiB,MAClBP,EAAO,IAAOqB,EAAM,CAAE,KAAMD,CAAA,CAAM,EAClCpB,EAAO,MAASqB,EAAM,CAAE,KAAMD,EAAM,CAC9C,EAEA,UAAavB,EAAkBC,EAAiC,CAC5D,OAAOE,EAAO,OAAUQ,EAAUX,EAAUC,CAAE,CAAC,CACnD,CAAA,EAGJ,OAAOW,CACX"}
+{"version":3,"file":"create-data-provider.cjs","names":[],"sources":["../../src/data/create-data-provider.ts"],"sourcesContent":["import type { ApiClient, RequestOptions } from \"@/http/types\";\nimport type { OffsetPage } from \"@/query/pagination\";\n\n/** Query-param values accepted by the API client for a list request. */\ntype ParamValue = string | number | boolean | undefined | null;\n\n/** Filters passed to {@link DataProvider.getList}, spread verbatim into the query string. */\nexport type DataFilters = Record<string, ParamValue>;\n\n/** Parameters for a paginated, sorted, filtered list request. */\nexport interface GetListParams {\n    /** Offset pagination — 1-based `page` and `pageSize`. */\n    pagination?: { page?: number; pageSize?: number };\n    /** Single-field sort. `order` defaults to `\"asc\"`. */\n    sort?: { field: string; order?: \"asc\" | \"desc\" };\n    /** Arbitrary filter query params, spread onto the request. */\n    filters?: DataFilters;\n}\n\n/**\n * Refine-style data provider over the Tempest FastAPI SDK CRUD/pagination\n * conventions. Implementations are stateless wrappers around an {@link ApiClient}.\n */\nexport interface DataProvider {\n    /**\n     * Fetch a paginated list of a resource.\n     *\n     * @param resource - The resource name (e.g. `\"users\"`).\n     * @param params - Pagination, sort and filter parameters.\n     * @returns The offset-paginated envelope.\n     */\n    getList<T>(resource: string, params?: GetListParams): Promise<OffsetPage<T>>;\n    /**\n     * Fetch a single record by id.\n     *\n     * @param resource - The resource name.\n     * @param id - The record id.\n     * @returns The record.\n     */\n    getOne<T>(resource: string, id: string | number): Promise<T>;\n    /**\n     * Fetch many records by id (default: parallel {@link DataProvider.getOne}).\n     *\n     * @param resource - The resource name.\n     * @param ids - The record ids.\n     * @returns The records, in the same order as `ids`.\n     */\n    getMany<T>(resource: string, ids: (string | number)[]): Promise<T[]>;\n    /**\n     * Create a record.\n     *\n     * @param resource - The resource name.\n     * @param data - The creation payload.\n     * @returns The created record.\n     */\n    create<T>(resource: string, data: unknown): Promise<T>;\n    /**\n     * Update a record (PATCH by default, PUT when configured).\n     *\n     * @param resource - The resource name.\n     * @param id - The record id.\n     * @param data - The update payload.\n     * @returns The updated record.\n     */\n    update<T>(resource: string, id: string | number, data: unknown): Promise<T>;\n    /**\n     * Delete a record by id.\n     *\n     * @param resource - The resource name.\n     * @param id - The record id.\n     * @returns The delete response (often the deleted record).\n     */\n    deleteOne<T>(resource: string, id: string | number): Promise<T>;\n}\n\n/** Options to tailor {@link createDataProvider} to a backend's conventions. */\nexport interface DataProviderOptions {\n    /** Query-param name for the page number. Default: `\"page\"`. */\n    pageParam?: string;\n    /** Query-param name for the page size. Default: `\"size\"`. */\n    sizeParam?: string;\n    /** Query-param name for the sort field. Default: `\"order_by\"`. */\n    sortFieldParam?: string;\n    /** Query-param name for the sort order. Default: `\"ascending\"`. */\n    sortOrderParam?: string;\n    /**\n     * When `true` (default), emit the sort order as a boolean\n     * (`order:\"asc\"` → `true`). When `false`, emit the literal `\"asc\"`/`\"desc\"`.\n     */\n    sortOrderAsBoolean?: boolean;\n    /** HTTP method used by {@link DataProvider.update}. Default: `\"patch\"`. */\n    updateMethod?: \"patch\" | \"put\";\n    /**\n     * Build the request path for a resource (and optional id).\n     * Default: `id == null ? \"/\" + resource : \"/\" + resource + \"/\" + id`.\n     */\n    buildPath?: (resource: string, id?: string | number) => string;\n}\n\nconst defaultBuildPath = (resource: string, id?: string | number): string =>\n    id == null ? `/${resource}` : `/${resource}/${id}`;\n\n/**\n * Create a {@link DataProvider} bound to an {@link ApiClient}.\n *\n * Maps Refine-style calls to the Tempest FastAPI SDK conventions: list →\n * `GET /{resource}?page=&size=&order_by=&ascending=&...filters`, one →\n * `GET /{resource}/{id}`, create → `POST`, update → `PATCH`/`PUT`,\n * delete → `DELETE`.\n *\n * @param client - The HTTP client created by `createApiClient`.\n * @param options - Optional overrides for param names, sort encoding,\n *   update method and path building.\n * @returns A stateless data provider.\n *\n * @example\n * const dataProvider = createDataProvider(apiClient);\n * const page = await dataProvider.getList<User>(\"users\", {\n *     pagination: { page: 1, pageSize: 20 },\n *     sort: { field: \"created_at\", order: \"desc\" },\n *     filters: { active: true },\n * });\n */\nexport function createDataProvider(\n    client: ApiClient,\n    options: DataProviderOptions = {},\n): DataProvider {\n    const {\n        pageParam = \"page\",\n        sizeParam = \"size\",\n        sortFieldParam = \"order_by\",\n        sortOrderParam = \"ascending\",\n        sortOrderAsBoolean = true,\n        updateMethod = \"patch\",\n        buildPath = defaultBuildPath,\n    } = options;\n\n    const provider: DataProvider = {\n        getList<T>(resource: string, params: GetListParams = {}): Promise<OffsetPage<T>> {\n            const { pagination, sort, filters } = params;\n            const query: Record<string, ParamValue> = {};\n\n            if (pagination?.page != null) query[pageParam] = pagination.page;\n            if (pagination?.pageSize != null) query[sizeParam] = pagination.pageSize;\n\n            if (sort?.field) {\n                const order = sort.order ?? \"asc\";\n                query[sortFieldParam] = sort.field;\n                query[sortOrderParam] = sortOrderAsBoolean ? order === \"asc\" : order;\n            }\n\n            if (filters) {\n                for (const [key, value] of Object.entries(filters)) {\n                    query[key] = value;\n                }\n            }\n\n            const requestOptions: RequestOptions = { params: query };\n            return client.get<OffsetPage<T>>(buildPath(resource), requestOptions);\n        },\n\n        getOne<T>(resource: string, id: string | number): Promise<T> {\n            return client.get<T>(buildPath(resource, id));\n        },\n\n        getMany<T>(resource: string, ids: (string | number)[]): Promise<T[]> {\n            return Promise.all(ids.map((id) => provider.getOne<T>(resource, id)));\n        },\n\n        create<T>(resource: string, data: unknown): Promise<T> {\n            return client.post<T>(buildPath(resource), { body: data });\n        },\n\n        update<T>(resource: string, id: string | number, data: unknown): Promise<T> {\n            const path = buildPath(resource, id);\n            return updateMethod === \"put\"\n                ? client.put<T>(path, { body: data })\n                : client.patch<T>(path, { body: data });\n        },\n\n        deleteOne<T>(resource: string, id: string | number): Promise<T> {\n            return client.delete<T>(buildPath(resource, id));\n        },\n    };\n\n    return provider;\n}\n"],"mappings":"AAmGA,IAAM,GAAoB,EAAkB,IACxC,GAAM,KAAO,IAAI,IAAa,IAAI,EAAS,GAAG,IAuBlD,SAAgB,EACZ,EACA,EAA+B,CAAC,EACpB,CACZ,GAAM,CACF,YAAY,OACZ,YAAY,OACZ,iBAAiB,WACjB,iBAAiB,YACjB,qBAAqB,GACrB,eAAe,QACf,YAAY,GACZ,EAEE,EAAyB,CAC3B,QAAW,EAAkB,EAAwB,CAAC,EAA2B,CAC7E,GAAM,CAAE,aAAY,OAAM,WAAY,EAChC,EAAoC,CAAC,EAK3C,GAHI,GAAY,MAAQ,OAAM,EAAM,GAAa,EAAW,MACxD,GAAY,UAAY,OAAM,EAAM,GAAa,EAAW,UAE5D,GAAM,MAAO,CACb,IAAM,EAAQ,EAAK,OAAS,MAC5B,EAAM,GAAkB,EAAK,MAC7B,EAAM,GAAkB,EAAqB,IAAU,MAAQ,CACnE,CAEA,GAAI,EACA,IAAK,GAAM,CAAC,EAAK,KAAU,OAAO,QAAQ,CAAO,EAC7C,EAAM,GAAO,EAIrB,IAAM,EAAiC,CAAE,OAAQ,CAAM,EACvD,OAAO,EAAO,IAAmB,EAAU,CAAQ,EAAG,CAAc,CACxE,EAEA,OAAU,EAAkB,EAAiC,CACzD,OAAO,EAAO,IAAO,EAAU,EAAU,CAAE,CAAC,CAChD,EAEA,QAAW,EAAkB,EAAwC,CACjE,OAAO,QAAQ,IAAI,EAAI,IAAK,GAAO,EAAS,OAAU,EAAU,CAAE,CAAC,CAAC,CACxE,EAEA,OAAU,EAAkB,EAA2B,CACnD,OAAO,EAAO,KAAQ,EAAU,CAAQ,EAAG,CAAE,KAAM,CAAK,CAAC,CAC7D,EAEA,OAAU,EAAkB,EAAqB,EAA2B,CACxE,IAAM,EAAO,EAAU,EAAU,CAAE,EACnC,OAAO,IAAiB,MAClB,EAAO,IAAO,EAAM,CAAE,KAAM,CAAK,CAAC,EAClC,EAAO,MAAS,EAAM,CAAE,KAAM,CAAK,CAAC,CAC9C,EAEA,UAAa,EAAkB,EAAiC,CAC5D,OAAO,EAAO,OAAU,EAAU,EAAU,CAAE,CAAC,CACnD,CACJ,EAEA,OAAO,CACX"}

package/dist/data/create-data-provider.js

@@ -1,46 +1,37 @@
-const b = (r, u) => u == null ? `/${r}` : `/${r}/${u}`;
-function h(r, u = {}) {
-  const {
-    pageParam: g = "page",
-    sizeParam: l = "size",
-    sortFieldParam: c = "order_by",
-    sortOrderParam: f = "ascending",
-    sortOrderAsBoolean: P = !0,
-    updateMethod: m = "patch",
-    buildPath: s = b
-  } = u, p = {
-    getList(e, t = {}) {
-      const { pagination: a, sort: o, filters: i } = t, n = {};
-      if (a?.page != null && (n[g] = a.page), a?.pageSize != null && (n[l] = a.pageSize), o?.field) {
-        const d = o.order ?? "asc";
-        n[c] = o.field, n[f] = P ? d === "asc" : d;
-      }
-      if (i)
-        for (const [d, O] of Object.entries(i))
-          n[d] = O;
-      const y = { params: n };
-      return r.get(s(e), y);
-    },
-    getOne(e, t) {
-      return r.get(s(e, t));
-    },
-    getMany(e, t) {
-      return Promise.all(t.map((a) => p.getOne(e, a)));
-    },
-    create(e, t) {
-      return r.post(s(e), { body: t });
-    },
-    update(e, t, a) {
-      const o = s(e, t);
-      return m === "put" ? r.put(o, { body: a }) : r.patch(o, { body: a });
-    },
-    deleteOne(e, t) {
-      return r.delete(s(e, t));
-    }
-  };
-  return p;
+//#region src/data/create-data-provider.ts
+var e = (e, t) => t == null ? `/${e}` : `/${e}/${t}`;
+function t(t, n = {}) {
+	let { pageParam: r = "page", sizeParam: i = "size", sortFieldParam: a = "order_by", sortOrderParam: o = "ascending", sortOrderAsBoolean: s = !0, updateMethod: c = "patch", buildPath: l = e } = n, u = {
+		getList(e, n = {}) {
+			let { pagination: c, sort: u, filters: d } = n, f = {};
+			if (c?.page != null && (f[r] = c.page), c?.pageSize != null && (f[i] = c.pageSize), u?.field) {
+				let e = u.order ?? "asc";
+				f[a] = u.field, f[o] = s ? e === "asc" : e;
+			}
+			if (d) for (let [e, t] of Object.entries(d)) f[e] = t;
+			let p = { params: f };
+			return t.get(l(e), p);
+		},
+		getOne(e, n) {
+			return t.get(l(e, n));
+		},
+		getMany(e, t) {
+			return Promise.all(t.map((t) => u.getOne(e, t)));
+		},
+		create(e, n) {
+			return t.post(l(e), { body: n });
+		},
+		update(e, n, r) {
+			let i = l(e, n);
+			return c === "put" ? t.put(i, { body: r }) : t.patch(i, { body: r });
+		},
+		deleteOne(e, n) {
+			return t.delete(l(e, n));
+		}
+	};
+	return u;
 }
-export {
-  h as createDataProvider
-};
-//# sourceMappingURL=create-data-provider.js.map
+//#endregion
+export { t as createDataProvider };
+
+//# sourceMappingURL=create-data-provider.js.map

package/dist/data/create-data-provider.js.map

@@ -1 +1 @@
-{"version":3,"file":"create-data-provider.js","sources":["../../src/data/create-data-provider.ts"],"sourcesContent":["import type { ApiClient, RequestOptions } from \"@/http/types\";\nimport type { OffsetPage } from \"@/query/pagination\";\n\n/** Query-param values accepted by the API client for a list request. */\ntype ParamValue = string | number | boolean | undefined | null;\n\n/** Filters passed to {@link DataProvider.getList}, spread verbatim into the query string. */\nexport type DataFilters = Record<string, ParamValue>;\n\n/** Parameters for a paginated, sorted, filtered list request. */\nexport interface GetListParams {\n    /** Offset pagination — 1-based `page` and `pageSize`. */\n    pagination?: { page?: number; pageSize?: number };\n    /** Single-field sort. `order` defaults to `\"asc\"`. */\n    sort?: { field: string; order?: \"asc\" | \"desc\" };\n    /** Arbitrary filter query params, spread onto the request. */\n    filters?: DataFilters;\n}\n\n/**\n * Refine-style data provider over the Tempest FastAPI SDK CRUD/pagination\n * conventions. Implementations are stateless wrappers around an {@link ApiClient}.\n */\nexport interface DataProvider {\n    /**\n     * Fetch a paginated list of a resource.\n     *\n     * @param resource - The resource name (e.g. `\"users\"`).\n     * @param params - Pagination, sort and filter parameters.\n     * @returns The offset-paginated envelope.\n     */\n    getList<T>(resource: string, params?: GetListParams): Promise<OffsetPage<T>>;\n    /**\n     * Fetch a single record by id.\n     *\n     * @param resource - The resource name.\n     * @param id - The record id.\n     * @returns The record.\n     */\n    getOne<T>(resource: string, id: string | number): Promise<T>;\n    /**\n     * Fetch many records by id (default: parallel {@link DataProvider.getOne}).\n     *\n     * @param resource - The resource name.\n     * @param ids - The record ids.\n     * @returns The records, in the same order as `ids`.\n     */\n    getMany<T>(resource: string, ids: (string | number)[]): Promise<T[]>;\n    /**\n     * Create a record.\n     *\n     * @param resource - The resource name.\n     * @param data - The creation payload.\n     * @returns The created record.\n     */\n    create<T>(resource: string, data: unknown): Promise<T>;\n    /**\n     * Update a record (PATCH by default, PUT when configured).\n     *\n     * @param resource - The resource name.\n     * @param id - The record id.\n     * @param data - The update payload.\n     * @returns The updated record.\n     */\n    update<T>(resource: string, id: string | number, data: unknown): Promise<T>;\n    /**\n     * Delete a record by id.\n     *\n     * @param resource - The resource name.\n     * @param id - The record id.\n     * @returns The delete response (often the deleted record).\n     */\n    deleteOne<T>(resource: string, id: string | number): Promise<T>;\n}\n\n/** Options to tailor {@link createDataProvider} to a backend's conventions. */\nexport interface DataProviderOptions {\n    /** Query-param name for the page number. Default: `\"page\"`. */\n    pageParam?: string;\n    /** Query-param name for the page size. Default: `\"size\"`. */\n    sizeParam?: string;\n    /** Query-param name for the sort field. Default: `\"order_by\"`. */\n    sortFieldParam?: string;\n    /** Query-param name for the sort order. Default: `\"ascending\"`. */\n    sortOrderParam?: string;\n    /**\n     * When `true` (default), emit the sort order as a boolean\n     * (`order:\"asc\"` → `true`). When `false`, emit the literal `\"asc\"`/`\"desc\"`.\n     */\n    sortOrderAsBoolean?: boolean;\n    /** HTTP method used by {@link DataProvider.update}. Default: `\"patch\"`. */\n    updateMethod?: \"patch\" | \"put\";\n    /**\n     * Build the request path for a resource (and optional id).\n     * Default: `id == null ? \"/\" + resource : \"/\" + resource + \"/\" + id`.\n     */\n    buildPath?: (resource: string, id?: string | number) => string;\n}\n\nconst defaultBuildPath = (resource: string, id?: string | number): string =>\n    id == null ? `/${resource}` : `/${resource}/${id}`;\n\n/**\n * Create a {@link DataProvider} bound to an {@link ApiClient}.\n *\n * Maps Refine-style calls to the Tempest FastAPI SDK conventions: list →\n * `GET /{resource}?page=&size=&order_by=&ascending=&...filters`, one →\n * `GET /{resource}/{id}`, create → `POST`, update → `PATCH`/`PUT`,\n * delete → `DELETE`.\n *\n * @param client - The HTTP client created by `createApiClient`.\n * @param options - Optional overrides for param names, sort encoding,\n *   update method and path building.\n * @returns A stateless data provider.\n *\n * @example\n * const dataProvider = createDataProvider(apiClient);\n * const page = await dataProvider.getList<User>(\"users\", {\n *     pagination: { page: 1, pageSize: 20 },\n *     sort: { field: \"created_at\", order: \"desc\" },\n *     filters: { active: true },\n * });\n */\nexport function createDataProvider(\n    client: ApiClient,\n    options: DataProviderOptions = {},\n): DataProvider {\n    const {\n        pageParam = \"page\",\n        sizeParam = \"size\",\n        sortFieldParam = \"order_by\",\n        sortOrderParam = \"ascending\",\n        sortOrderAsBoolean = true,\n        updateMethod = \"patch\",\n        buildPath = defaultBuildPath,\n    } = options;\n\n    const provider: DataProvider = {\n        getList<T>(resource: string, params: GetListParams = {}): Promise<OffsetPage<T>> {\n            const { pagination, sort, filters } = params;\n            const query: Record<string, ParamValue> = {};\n\n            if (pagination?.page != null) query[pageParam] = pagination.page;\n            if (pagination?.pageSize != null) query[sizeParam] = pagination.pageSize;\n\n            if (sort?.field) {\n                const order = sort.order ?? \"asc\";\n                query[sortFieldParam] = sort.field;\n                query[sortOrderParam] = sortOrderAsBoolean ? order === \"asc\" : order;\n            }\n\n            if (filters) {\n                for (const [key, value] of Object.entries(filters)) {\n                    query[key] = value;\n                }\n            }\n\n            const requestOptions: RequestOptions = { params: query };\n            return client.get<OffsetPage<T>>(buildPath(resource), requestOptions);\n        },\n\n        getOne<T>(resource: string, id: string | number): Promise<T> {\n            return client.get<T>(buildPath(resource, id));\n        },\n\n        getMany<T>(resource: string, ids: (string | number)[]): Promise<T[]> {\n            return Promise.all(ids.map((id) => provider.getOne<T>(resource, id)));\n        },\n\n        create<T>(resource: string, data: unknown): Promise<T> {\n            return client.post<T>(buildPath(resource), { body: data });\n        },\n\n        update<T>(resource: string, id: string | number, data: unknown): Promise<T> {\n            const path = buildPath(resource, id);\n            return updateMethod === \"put\"\n                ? client.put<T>(path, { body: data })\n                : client.patch<T>(path, { body: data });\n        },\n\n        deleteOne<T>(resource: string, id: string | number): Promise<T> {\n            return client.delete<T>(buildPath(resource, id));\n        },\n    };\n\n    return provider;\n}\n"],"names":["defaultBuildPath","resource","id","createDataProvider","client","options","pageParam","sizeParam","sortFieldParam","sortOrderParam","sortOrderAsBoolean","updateMethod","buildPath","provider","params","pagination","sort","filters","query","order","key","value","requestOptions","ids","data","path"],"mappings":"AAmGA,MAAMA,IAAmB,CAACC,GAAkBC,MACxCA,KAAM,OAAO,IAAID,CAAQ,KAAK,IAAIA,CAAQ,IAAIC,CAAE;AAuB7C,SAASC,EACZC,GACAC,IAA+B,IACnB;AACZ,QAAM;AAAA,IACF,WAAAC,IAAY;AAAA,IACZ,WAAAC,IAAY;AAAA,IACZ,gBAAAC,IAAiB;AAAA,IACjB,gBAAAC,IAAiB;AAAA,IACjB,oBAAAC,IAAqB;AAAA,IACrB,cAAAC,IAAe;AAAA,IACf,WAAAC,IAAYZ;AAAA,EAAA,IACZK,GAEEQ,IAAyB;AAAA,IAC3B,QAAWZ,GAAkBa,IAAwB,IAA4B;AAC7E,YAAM,EAAE,YAAAC,GAAY,MAAAC,GAAM,SAAAC,EAAA,IAAYH,GAChCI,IAAoC,CAAA;AAK1C,UAHIH,GAAY,QAAQ,SAAMG,EAAMZ,CAAS,IAAIS,EAAW,OACxDA,GAAY,YAAY,SAAMG,EAAMX,CAAS,IAAIQ,EAAW,WAE5DC,GAAM,OAAO;AACb,cAAMG,IAAQH,EAAK,SAAS;AAC5B,QAAAE,EAAMV,CAAc,IAAIQ,EAAK,OAC7BE,EAAMT,CAAc,IAAIC,IAAqBS,MAAU,QAAQA;AAAA,MACnE;AAEA,UAAIF;AACA,mBAAW,CAACG,GAAKC,CAAK,KAAK,OAAO,QAAQJ,CAAO;AAC7C,UAAAC,EAAME,CAAG,IAAIC;AAIrB,YAAMC,IAAiC,EAAE,QAAQJ,EAAA;AACjD,aAAOd,EAAO,IAAmBQ,EAAUX,CAAQ,GAAGqB,CAAc;AAAA,IACxE;AAAA,IAEA,OAAUrB,GAAkBC,GAAiC;AACzD,aAAOE,EAAO,IAAOQ,EAAUX,GAAUC,CAAE,CAAC;AAAA,IAChD;AAAA,IAEA,QAAWD,GAAkBsB,GAAwC;AACjE,aAAO,QAAQ,IAAIA,EAAI,IAAI,CAACrB,MAAOW,EAAS,OAAUZ,GAAUC,CAAE,CAAC,CAAC;AAAA,IACxE;AAAA,IAEA,OAAUD,GAAkBuB,GAA2B;AACnD,aAAOpB,EAAO,KAAQQ,EAAUX,CAAQ,GAAG,EAAE,MAAMuB,GAAM;AAAA,IAC7D;AAAA,IAEA,OAAUvB,GAAkBC,GAAqBsB,GAA2B;AACxE,YAAMC,IAAOb,EAAUX,GAAUC,CAAE;AACnC,aAAOS,MAAiB,QAClBP,EAAO,IAAOqB,GAAM,EAAE,MAAMD,EAAA,CAAM,IAClCpB,EAAO,MAASqB,GAAM,EAAE,MAAMD,GAAM;AAAA,IAC9C;AAAA,IAEA,UAAavB,GAAkBC,GAAiC;AAC5D,aAAOE,EAAO,OAAUQ,EAAUX,GAAUC,CAAE,CAAC;AAAA,IACnD;AAAA,EAAA;AAGJ,SAAOW;AACX;"}
+{"version":3,"file":"create-data-provider.js","names":[],"sources":["../../src/data/create-data-provider.ts"],"sourcesContent":["import type { ApiClient, RequestOptions } from \"@/http/types\";\nimport type { OffsetPage } from \"@/query/pagination\";\n\n/** Query-param values accepted by the API client for a list request. */\ntype ParamValue = string | number | boolean | undefined | null;\n\n/** Filters passed to {@link DataProvider.getList}, spread verbatim into the query string. */\nexport type DataFilters = Record<string, ParamValue>;\n\n/** Parameters for a paginated, sorted, filtered list request. */\nexport interface GetListParams {\n    /** Offset pagination — 1-based `page` and `pageSize`. */\n    pagination?: { page?: number; pageSize?: number };\n    /** Single-field sort. `order` defaults to `\"asc\"`. */\n    sort?: { field: string; order?: \"asc\" | \"desc\" };\n    /** Arbitrary filter query params, spread onto the request. */\n    filters?: DataFilters;\n}\n\n/**\n * Refine-style data provider over the Tempest FastAPI SDK CRUD/pagination\n * conventions. Implementations are stateless wrappers around an {@link ApiClient}.\n */\nexport interface DataProvider {\n    /**\n     * Fetch a paginated list of a resource.\n     *\n     * @param resource - The resource name (e.g. `\"users\"`).\n     * @param params - Pagination, sort and filter parameters.\n     * @returns The offset-paginated envelope.\n     */\n    getList<T>(resource: string, params?: GetListParams): Promise<OffsetPage<T>>;\n    /**\n     * Fetch a single record by id.\n     *\n     * @param resource - The resource name.\n     * @param id - The record id.\n     * @returns The record.\n     */\n    getOne<T>(resource: string, id: string | number): Promise<T>;\n    /**\n     * Fetch many records by id (default: parallel {@link DataProvider.getOne}).\n     *\n     * @param resource - The resource name.\n     * @param ids - The record ids.\n     * @returns The records, in the same order as `ids`.\n     */\n    getMany<T>(resource: string, ids: (string | number)[]): Promise<T[]>;\n    /**\n     * Create a record.\n     *\n     * @param resource - The resource name.\n     * @param data - The creation payload.\n     * @returns The created record.\n     */\n    create<T>(resource: string, data: unknown): Promise<T>;\n    /**\n     * Update a record (PATCH by default, PUT when configured).\n     *\n     * @param resource - The resource name.\n     * @param id - The record id.\n     * @param data - The update payload.\n     * @returns The updated record.\n     */\n    update<T>(resource: string, id: string | number, data: unknown): Promise<T>;\n    /**\n     * Delete a record by id.\n     *\n     * @param resource - The resource name.\n     * @param id - The record id.\n     * @returns The delete response (often the deleted record).\n     */\n    deleteOne<T>(resource: string, id: string | number): Promise<T>;\n}\n\n/** Options to tailor {@link createDataProvider} to a backend's conventions. */\nexport interface DataProviderOptions {\n    /** Query-param name for the page number. Default: `\"page\"`. */\n    pageParam?: string;\n    /** Query-param name for the page size. Default: `\"size\"`. */\n    sizeParam?: string;\n    /** Query-param name for the sort field. Default: `\"order_by\"`. */\n    sortFieldParam?: string;\n    /** Query-param name for the sort order. Default: `\"ascending\"`. */\n    sortOrderParam?: string;\n    /**\n     * When `true` (default), emit the sort order as a boolean\n     * (`order:\"asc\"` → `true`). When `false`, emit the literal `\"asc\"`/`\"desc\"`.\n     */\n    sortOrderAsBoolean?: boolean;\n    /** HTTP method used by {@link DataProvider.update}. Default: `\"patch\"`. */\n    updateMethod?: \"patch\" | \"put\";\n    /**\n     * Build the request path for a resource (and optional id).\n     * Default: `id == null ? \"/\" + resource : \"/\" + resource + \"/\" + id`.\n     */\n    buildPath?: (resource: string, id?: string | number) => string;\n}\n\nconst defaultBuildPath = (resource: string, id?: string | number): string =>\n    id == null ? `/${resource}` : `/${resource}/${id}`;\n\n/**\n * Create a {@link DataProvider} bound to an {@link ApiClient}.\n *\n * Maps Refine-style calls to the Tempest FastAPI SDK conventions: list →\n * `GET /{resource}?page=&size=&order_by=&ascending=&...filters`, one →\n * `GET /{resource}/{id}`, create → `POST`, update → `PATCH`/`PUT`,\n * delete → `DELETE`.\n *\n * @param client - The HTTP client created by `createApiClient`.\n * @param options - Optional overrides for param names, sort encoding,\n *   update method and path building.\n * @returns A stateless data provider.\n *\n * @example\n * const dataProvider = createDataProvider(apiClient);\n * const page = await dataProvider.getList<User>(\"users\", {\n *     pagination: { page: 1, pageSize: 20 },\n *     sort: { field: \"created_at\", order: \"desc\" },\n *     filters: { active: true },\n * });\n */\nexport function createDataProvider(\n    client: ApiClient,\n    options: DataProviderOptions = {},\n): DataProvider {\n    const {\n        pageParam = \"page\",\n        sizeParam = \"size\",\n        sortFieldParam = \"order_by\",\n        sortOrderParam = \"ascending\",\n        sortOrderAsBoolean = true,\n        updateMethod = \"patch\",\n        buildPath = defaultBuildPath,\n    } = options;\n\n    const provider: DataProvider = {\n        getList<T>(resource: string, params: GetListParams = {}): Promise<OffsetPage<T>> {\n            const { pagination, sort, filters } = params;\n            const query: Record<string, ParamValue> = {};\n\n            if (pagination?.page != null) query[pageParam] = pagination.page;\n            if (pagination?.pageSize != null) query[sizeParam] = pagination.pageSize;\n\n            if (sort?.field) {\n                const order = sort.order ?? \"asc\";\n                query[sortFieldParam] = sort.field;\n                query[sortOrderParam] = sortOrderAsBoolean ? order === \"asc\" : order;\n            }\n\n            if (filters) {\n                for (const [key, value] of Object.entries(filters)) {\n                    query[key] = value;\n                }\n            }\n\n            const requestOptions: RequestOptions = { params: query };\n            return client.get<OffsetPage<T>>(buildPath(resource), requestOptions);\n        },\n\n        getOne<T>(resource: string, id: string | number): Promise<T> {\n            return client.get<T>(buildPath(resource, id));\n        },\n\n        getMany<T>(resource: string, ids: (string | number)[]): Promise<T[]> {\n            return Promise.all(ids.map((id) => provider.getOne<T>(resource, id)));\n        },\n\n        create<T>(resource: string, data: unknown): Promise<T> {\n            return client.post<T>(buildPath(resource), { body: data });\n        },\n\n        update<T>(resource: string, id: string | number, data: unknown): Promise<T> {\n            const path = buildPath(resource, id);\n            return updateMethod === \"put\"\n                ? client.put<T>(path, { body: data })\n                : client.patch<T>(path, { body: data });\n        },\n\n        deleteOne<T>(resource: string, id: string | number): Promise<T> {\n            return client.delete<T>(buildPath(resource, id));\n        },\n    };\n\n    return provider;\n}\n"],"mappings":";AAmGA,IAAM,KAAoB,GAAkB,MACxC,KAAM,OAAO,IAAI,MAAa,IAAI,EAAS,GAAG;AAuBlD,SAAgB,EACZ,GACA,IAA+B,CAAC,GACpB;CACZ,IAAM,EACF,eAAY,QACZ,eAAY,QACZ,oBAAiB,YACjB,oBAAiB,aACjB,wBAAqB,IACrB,kBAAe,SACf,eAAY,MACZ,GAEE,IAAyB;EAC3B,QAAW,GAAkB,IAAwB,CAAC,GAA2B;GAC7E,IAAM,EAAE,eAAY,SAAM,eAAY,GAChC,IAAoC,CAAC;GAK3C,IAHI,GAAY,QAAQ,SAAM,EAAM,KAAa,EAAW,OACxD,GAAY,YAAY,SAAM,EAAM,KAAa,EAAW,WAE5D,GAAM,OAAO;IACb,IAAM,IAAQ,EAAK,SAAS;IAE5B,AADA,EAAM,KAAkB,EAAK,OAC7B,EAAM,KAAkB,IAAqB,MAAU,QAAQ;GACnE;GAEA,IAAI,GACA,KAAK,IAAM,CAAC,GAAK,MAAU,OAAO,QAAQ,CAAO,GAC7C,EAAM,KAAO;GAIrB,IAAM,IAAiC,EAAE,QAAQ,EAAM;GACvD,OAAO,EAAO,IAAmB,EAAU,CAAQ,GAAG,CAAc;EACxE;EAEA,OAAU,GAAkB,GAAiC;GACzD,OAAO,EAAO,IAAO,EAAU,GAAU,CAAE,CAAC;EAChD;EAEA,QAAW,GAAkB,GAAwC;GACjE,OAAO,QAAQ,IAAI,EAAI,KAAK,MAAO,EAAS,OAAU,GAAU,CAAE,CAAC,CAAC;EACxE;EAEA,OAAU,GAAkB,GAA2B;GACnD,OAAO,EAAO,KAAQ,EAAU,CAAQ,GAAG,EAAE,MAAM,EAAK,CAAC;EAC7D;EAEA,OAAU,GAAkB,GAAqB,GAA2B;GACxE,IAAM,IAAO,EAAU,GAAU,CAAE;GACnC,OAAO,MAAiB,QAClB,EAAO,IAAO,GAAM,EAAE,MAAM,EAAK,CAAC,IAClC,EAAO,MAAS,GAAM,EAAE,MAAM,EAAK,CAAC;EAC9C;EAEA,UAAa,GAAkB,GAAiC;GAC5D,OAAO,EAAO,OAAU,EAAU,GAAU,CAAE,CAAC;EACnD;CACJ;CAEA,OAAO;AACX"}

package/dist/data/data-provider-context.cjs

@@ -1,2 +1,2 @@
-"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const a=require("react/jsx-runtime"),r=require("react"),t=r.createContext(null);function i({provider:e,children:o}){return a.jsx(t.Provider,{value:e,children:o})}function n(){const e=r.useContext(t);if(!e)throw new Error("useDataProvider must be used within a <TempestDataProvider>");return e}exports.TempestDataProvider=i;exports.useDataProvider=n;
-//# sourceMappingURL=data-provider-context.cjs.map
+let e=require("react"),t=require("react/jsx-runtime");var n=(0,e.createContext)(null);function r({provider:e,children:r}){return(0,t.jsx)(n.Provider,{value:e,children:r})}function i(){let t=(0,e.useContext)(n);if(!t)throw Error(`useDataProvider must be used within a <TempestDataProvider>`);return t}exports.TempestDataProvider=r,exports.useDataProvider=i;
+//# sourceMappingURL=data-provider-context.cjs.map

package/dist/data/data-provider-context.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"data-provider-context.cjs","sources":["../../src/data/data-provider-context.tsx"],"sourcesContent":["import { createContext, useContext } from \"react\";\nimport type { ReactNode } from \"react\";\n\nimport type { DataProvider } from \"./create-data-provider\";\n\nconst DataProviderContext = createContext<DataProvider | null>(null);\n\n/** Props for {@link TempestDataProvider}. */\nexport interface TempestDataProviderProps {\n    /** The data provider to expose to descendant resource hooks. */\n    provider: DataProvider;\n    /** The subtree that consumes the provider. */\n    children: ReactNode;\n}\n\n/**\n * Inject a {@link DataProvider} into the React tree so the resource hooks\n * (`useList`, `useOne`, `useCreate`, …) can resolve it via {@link useDataProvider}.\n *\n * @example\n * const dataProvider = createDataProvider(apiClient);\n * <TempestDataProvider provider={dataProvider}>\n *     <App />\n * </TempestDataProvider>\n */\nexport function TempestDataProvider({ provider, children }: TempestDataProviderProps) {\n    return <DataProviderContext.Provider value={provider}>{children}</DataProviderContext.Provider>;\n}\n\n/**\n * Read the {@link DataProvider} from context.\n *\n * @returns The data provider supplied to the nearest {@link TempestDataProvider}.\n * @throws {Error} When used outside a {@link TempestDataProvider}.\n */\nexport function useDataProvider(): DataProvider {\n    const provider = useContext(DataProviderContext);\n    if (!provider) {\n        throw new Error(\"useDataProvider must be used within a <TempestDataProvider>\");\n    }\n    return provider;\n}\n"],"names":["DataProviderContext","createContext","TempestDataProvider","provider","children","useDataProvider","useContext"],"mappings":"wIAKMA,EAAsBC,EAAAA,cAAmC,IAAI,EAoB5D,SAASC,EAAoB,CAAE,SAAAC,EAAU,SAAAC,GAAsC,CAClF,aAAQJ,EAAoB,SAApB,CAA6B,MAAOG,EAAW,SAAAC,EAAS,CACpE,CAQO,SAASC,GAAgC,CAC5C,MAAMF,EAAWG,EAAAA,WAAWN,CAAmB,EAC/C,GAAI,CAACG,EACD,MAAM,IAAI,MAAM,6DAA6D,EAEjF,OAAOA,CACX"}
+{"version":3,"file":"data-provider-context.cjs","names":[],"sources":["../../src/data/data-provider-context.tsx"],"sourcesContent":["import { createContext, useContext } from \"react\";\nimport type { ReactNode } from \"react\";\n\nimport type { DataProvider } from \"./create-data-provider\";\n\nconst DataProviderContext = createContext<DataProvider | null>(null);\n\n/** Props for {@link TempestDataProvider}. */\nexport interface TempestDataProviderProps {\n    /** The data provider to expose to descendant resource hooks. */\n    provider: DataProvider;\n    /** The subtree that consumes the provider. */\n    children: ReactNode;\n}\n\n/**\n * Inject a {@link DataProvider} into the React tree so the resource hooks\n * (`useList`, `useOne`, `useCreate`, …) can resolve it via {@link useDataProvider}.\n *\n * @example\n * const dataProvider = createDataProvider(apiClient);\n * <TempestDataProvider provider={dataProvider}>\n *     <App />\n * </TempestDataProvider>\n */\nexport function TempestDataProvider({ provider, children }: TempestDataProviderProps) {\n    return <DataProviderContext.Provider value={provider}>{children}</DataProviderContext.Provider>;\n}\n\n/**\n * Read the {@link DataProvider} from context.\n *\n * @returns The data provider supplied to the nearest {@link TempestDataProvider}.\n * @throws {Error} When used outside a {@link TempestDataProvider}.\n */\nexport function useDataProvider(): DataProvider {\n    const provider = useContext(DataProviderContext);\n    if (!provider) {\n        throw new Error(\"useDataProvider must be used within a <TempestDataProvider>\");\n    }\n    return provider;\n}\n"],"mappings":"sDAKA,IAAM,GAAA,EAAA,EAAA,cAAA,CAAyD,IAAI,EAoBnE,SAAgB,EAAoB,CAAE,WAAU,YAAsC,CAClF,OAAO,EAAA,EAAA,IAAA,CAAC,EAAoB,SAArB,CAA8B,MAAO,EAAW,UAAuC,CAAA,CAClG,CAQA,SAAgB,GAAgC,CAC5C,IAAM,GAAA,EAAA,EAAA,WAAA,CAAsB,CAAmB,EAC/C,GAAI,CAAC,EACD,MAAU,MAAM,6DAA6D,EAEjF,OAAO,CACX"}

package/dist/data/data-provider-context.js

@@ -1,17 +1,19 @@
-import { jsx as o } from "react/jsx-runtime";
-import { useContext as i, createContext as n } from "react";
-const e = n(null);
-function s({ provider: r, children: t }) {
-  return /* @__PURE__ */ o(e.Provider, { value: r, children: t });
+import { createContext as e, useContext as t } from "react";
+import { jsx as n } from "react/jsx-runtime";
+//#region src/data/data-provider-context.tsx
+var r = e(null);
+function i({ provider: e, children: t }) {
+	return /* @__PURE__ */ n(r.Provider, {
+		value: e,
+		children: t
+	});
 }
-function d() {
-  const r = i(e);
-  if (!r)
-    throw new Error("useDataProvider must be used within a <TempestDataProvider>");
-  return r;
+function a() {
+	let e = t(r);
+	if (!e) throw Error("useDataProvider must be used within a <TempestDataProvider>");
+	return e;
 }
-export {
-  s as TempestDataProvider,
-  d as useDataProvider
-};
-//# sourceMappingURL=data-provider-context.js.map
+//#endregion
+export { i as TempestDataProvider, a as useDataProvider };
+
+//# sourceMappingURL=data-provider-context.js.map

package/dist/data/data-provider-context.js.map

@@ -1 +1 @@
-{"version":3,"file":"data-provider-context.js","sources":["../../src/data/data-provider-context.tsx"],"sourcesContent":["import { createContext, useContext } from \"react\";\nimport type { ReactNode } from \"react\";\n\nimport type { DataProvider } from \"./create-data-provider\";\n\nconst DataProviderContext = createContext<DataProvider | null>(null);\n\n/** Props for {@link TempestDataProvider}. */\nexport interface TempestDataProviderProps {\n    /** The data provider to expose to descendant resource hooks. */\n    provider: DataProvider;\n    /** The subtree that consumes the provider. */\n    children: ReactNode;\n}\n\n/**\n * Inject a {@link DataProvider} into the React tree so the resource hooks\n * (`useList`, `useOne`, `useCreate`, …) can resolve it via {@link useDataProvider}.\n *\n * @example\n * const dataProvider = createDataProvider(apiClient);\n * <TempestDataProvider provider={dataProvider}>\n *     <App />\n * </TempestDataProvider>\n */\nexport function TempestDataProvider({ provider, children }: TempestDataProviderProps) {\n    return <DataProviderContext.Provider value={provider}>{children}</DataProviderContext.Provider>;\n}\n\n/**\n * Read the {@link DataProvider} from context.\n *\n * @returns The data provider supplied to the nearest {@link TempestDataProvider}.\n * @throws {Error} When used outside a {@link TempestDataProvider}.\n */\nexport function useDataProvider(): DataProvider {\n    const provider = useContext(DataProviderContext);\n    if (!provider) {\n        throw new Error(\"useDataProvider must be used within a <TempestDataProvider>\");\n    }\n    return provider;\n}\n"],"names":["DataProviderContext","createContext","TempestDataProvider","provider","children","useDataProvider","useContext"],"mappings":";;AAKA,MAAMA,IAAsBC,EAAmC,IAAI;AAoB5D,SAASC,EAAoB,EAAE,UAAAC,GAAU,UAAAC,KAAsC;AAClF,2BAAQJ,EAAoB,UAApB,EAA6B,OAAOG,GAAW,UAAAC,GAAS;AACpE;AAQO,SAASC,IAAgC;AAC5C,QAAMF,IAAWG,EAAWN,CAAmB;AAC/C,MAAI,CAACG;AACD,UAAM,IAAI,MAAM,6DAA6D;AAEjF,SAAOA;AACX;"}
+{"version":3,"file":"data-provider-context.js","names":[],"sources":["../../src/data/data-provider-context.tsx"],"sourcesContent":["import { createContext, useContext } from \"react\";\nimport type { ReactNode } from \"react\";\n\nimport type { DataProvider } from \"./create-data-provider\";\n\nconst DataProviderContext = createContext<DataProvider | null>(null);\n\n/** Props for {@link TempestDataProvider}. */\nexport interface TempestDataProviderProps {\n    /** The data provider to expose to descendant resource hooks. */\n    provider: DataProvider;\n    /** The subtree that consumes the provider. */\n    children: ReactNode;\n}\n\n/**\n * Inject a {@link DataProvider} into the React tree so the resource hooks\n * (`useList`, `useOne`, `useCreate`, …) can resolve it via {@link useDataProvider}.\n *\n * @example\n * const dataProvider = createDataProvider(apiClient);\n * <TempestDataProvider provider={dataProvider}>\n *     <App />\n * </TempestDataProvider>\n */\nexport function TempestDataProvider({ provider, children }: TempestDataProviderProps) {\n    return <DataProviderContext.Provider value={provider}>{children}</DataProviderContext.Provider>;\n}\n\n/**\n * Read the {@link DataProvider} from context.\n *\n * @returns The data provider supplied to the nearest {@link TempestDataProvider}.\n * @throws {Error} When used outside a {@link TempestDataProvider}.\n */\nexport function useDataProvider(): DataProvider {\n    const provider = useContext(DataProviderContext);\n    if (!provider) {\n        throw new Error(\"useDataProvider must be used within a <TempestDataProvider>\");\n    }\n    return provider;\n}\n"],"mappings":";;;AAKA,IAAM,IAAsB,EAAmC,IAAI;AAoBnE,SAAgB,EAAoB,EAAE,aAAU,eAAsC;CAClF,OAAO,kBAAC,EAAoB,UAArB;EAA8B,OAAO;EAAW;CAAuC,CAAA;AAClG;AAQA,SAAgB,IAAgC;CAC5C,IAAM,IAAW,EAAW,CAAmB;CAC/C,IAAI,CAAC,GACD,MAAU,MAAM,6DAA6D;CAEjF,OAAO;AACX"}

package/dist/data/use-resource.cjs

@@ -1,2 +1,2 @@
-"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const i=require("@tanstack/react-query"),a=require("./data-provider-context.cjs");function y(e,t){return["data",e,"list",t]}function o(e,t){return["data",e,"one",t]}function d(e,t,r){const n=a.useDataProvider();return i.useQuery({queryKey:y(e,t),queryFn:()=>n.getList(e,t),...r})}function c(e,t,r){const n=a.useDataProvider(),{enabled:u,...s}=r??{};return i.useQuery({queryKey:o(e,t),queryFn:()=>n.getOne(e,t),enabled:t!=null&&(u??!0),...s})}function l(e,t){const r=a.useDataProvider(),n=i.useQueryClient();return i.useMutation({mutationFn:u=>r.create(e,u),onSuccess:(...u)=>{n.invalidateQueries({queryKey:["data",e,"list"]}),t?.onSuccess?.(...u)},...t})}function v(e,t){const r=a.useDataProvider(),n=i.useQueryClient();return i.useMutation({mutationFn:({id:u,data:s})=>r.update(e,u,s),onSuccess:(...u)=>{const[,s]=u;n.invalidateQueries({queryKey:["data",e,"list"]}),n.invalidateQueries({queryKey:o(e,s.id)}),t?.onSuccess?.(...u)},...t})}function Q(e,t){const r=a.useDataProvider(),n=i.useQueryClient();return i.useMutation({mutationFn:u=>r.deleteOne(e,u),onSuccess:(...u)=>{n.invalidateQueries({queryKey:["data",e,"list"]}),t?.onSuccess?.(...u)},...t})}exports.listQueryKey=y;exports.oneQueryKey=o;exports.useCreate=l;exports.useDelete=Q;exports.useList=d;exports.useOne=c;exports.useUpdate=v;
-//# sourceMappingURL=use-resource.cjs.map
+const e=require("./data-provider-context.cjs");let t=require("@tanstack/react-query");function n(e,t){return[`data`,e,`list`,t]}function r(e,t){return[`data`,e,`one`,t]}function i(r,i,a){let o=e.useDataProvider();return(0,t.useQuery)({queryKey:n(r,i),queryFn:()=>o.getList(r,i),...a})}function a(n,i,a){let o=e.useDataProvider(),{enabled:s,...c}=a??{};return(0,t.useQuery)({queryKey:r(n,i),queryFn:()=>o.getOne(n,i),enabled:i!=null&&(s??!0),...c})}function o(n,r){let i=e.useDataProvider(),a=(0,t.useQueryClient)();return(0,t.useMutation)({mutationFn:e=>i.create(n,e),onSuccess:(...e)=>{a.invalidateQueries({queryKey:[`data`,n,`list`]}),r?.onSuccess?.(...e)},...r})}function s(n,i){let a=e.useDataProvider(),o=(0,t.useQueryClient)();return(0,t.useMutation)({mutationFn:({id:e,data:t})=>a.update(n,e,t),onSuccess:(...e)=>{let[,t]=e;o.invalidateQueries({queryKey:[`data`,n,`list`]}),o.invalidateQueries({queryKey:r(n,t.id)}),i?.onSuccess?.(...e)},...i})}function c(n,r){let i=e.useDataProvider(),a=(0,t.useQueryClient)();return(0,t.useMutation)({mutationFn:e=>i.deleteOne(n,e),onSuccess:(...e)=>{a.invalidateQueries({queryKey:[`data`,n,`list`]}),r?.onSuccess?.(...e)},...r})}exports.listQueryKey=n,exports.oneQueryKey=r,exports.useCreate=o,exports.useDelete=c,exports.useList=i,exports.useOne=a,exports.useUpdate=s;
+//# sourceMappingURL=use-resource.cjs.map

package/dist/data/use-resource.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"use-resource.cjs","sources":["../../src/data/use-resource.ts"],"sourcesContent":["import { useMutation, useQuery, useQueryClient } from \"@tanstack/react-query\";\nimport type {\n    UseMutationOptions,\n    UseMutationResult,\n    UseQueryOptions,\n    UseQueryResult,\n} from \"@tanstack/react-query\";\n\nimport type { OffsetPage } from \"@/query/pagination\";\n\nimport type { GetListParams } from \"./create-data-provider\";\nimport { useDataProvider } from \"./data-provider-context\";\n\n/** Extra TanStack Query options for {@link useList} (key + fn are provided). */\nexport type UseListOptions<T> = Omit<\n    UseQueryOptions<OffsetPage<T>, Error, OffsetPage<T>>,\n    \"queryKey\" | \"queryFn\"\n>;\n\n/** Extra TanStack Query options for {@link useOne} (key + fn + enabled are provided). */\nexport type UseOneOptions<T> = Omit<\n    UseQueryOptions<T, Error, T>,\n    \"queryKey\" | \"queryFn\" | \"enabled\"\n> & { enabled?: boolean };\n\n/**\n * Build the cache key for a resource list query.\n *\n * @param resource - The resource name.\n * @param params - The list params (page/sort/filters).\n * @returns A stable TanStack Query key.\n */\nexport function listQueryKey(resource: string, params?: GetListParams): unknown[] {\n    return [\"data\", resource, \"list\", params];\n}\n\n/**\n * Build the cache key for a single-record query.\n *\n * @param resource - The resource name.\n * @param id - The record id.\n * @returns A stable TanStack Query key.\n */\nexport function oneQueryKey(resource: string, id: string | number | null | undefined): unknown[] {\n    return [\"data\", resource, \"one\", id];\n}\n\n/**\n * Query a paginated list of a resource through the active {@link useDataProvider}.\n *\n * @param resource - The resource name.\n * @param params - Pagination, sort and filter parameters.\n * @param options - Extra TanStack Query options.\n * @returns The TanStack Query result for the offset page.\n */\nexport function useList<T>(\n    resource: string,\n    params?: GetListParams,\n    options?: UseListOptions<T>,\n): UseQueryResult<OffsetPage<T>, Error> {\n    const provider = useDataProvider();\n    return useQuery<OffsetPage<T>, Error>({\n        queryKey: listQueryKey(resource, params),\n        queryFn: () => provider.getList<T>(resource, params),\n        ...options,\n    });\n}\n\n/**\n * Query a single record by id through the active {@link useDataProvider}.\n *\n * The query is disabled while `id` is `null`/`undefined`.\n *\n * @param resource - The resource name.\n * @param id - The record id.\n * @param options - Extra TanStack Query options.\n * @returns The TanStack Query result for the record.\n */\nexport function useOne<T>(\n    resource: string,\n    id: string | number | null | undefined,\n    options?: UseOneOptions<T>,\n): UseQueryResult<T, Error> {\n    const provider = useDataProvider();\n    const { enabled, ...rest } = options ?? {};\n    return useQuery<T, Error>({\n        queryKey: oneQueryKey(resource, id),\n        queryFn: () => provider.getOne<T>(resource, id as string | number),\n        enabled: id != null && (enabled ?? true),\n        ...rest,\n    });\n}\n\n/** Options for the create mutation (mutationFn + onSuccess are provided). */\nexport type UseCreateOptions<T> = Omit<UseMutationOptions<T, Error, unknown>, \"mutationFn\">;\n\n/**\n * Create a record and invalidate the resource list cache on success.\n *\n * @param resource - The resource name.\n * @param options - Extra TanStack Mutation options.\n * @returns The mutation; `mutate(data)` creates the record.\n */\nexport function useCreate<T>(\n    resource: string,\n    options?: UseCreateOptions<T>,\n): UseMutationResult<T, Error, unknown> {\n    const provider = useDataProvider();\n    const queryClient = useQueryClient();\n    return useMutation<T, Error, unknown>({\n        mutationFn: (data: unknown) => provider.create<T>(resource, data),\n        onSuccess: (...args) => {\n            void queryClient.invalidateQueries({ queryKey: [\"data\", resource, \"list\"] });\n            options?.onSuccess?.(...args);\n        },\n        ...options,\n    });\n}\n\n/** Variables accepted by the update mutation. */\nexport interface UpdateVariables {\n    /** The record id to update. */\n    id: string | number;\n    /** The update payload. */\n    data: unknown;\n}\n\n/** Options for the update mutation (mutationFn + onSuccess are provided). */\nexport type UseUpdateOptions<T> = Omit<UseMutationOptions<T, Error, UpdateVariables>, \"mutationFn\">;\n\n/**\n * Update a record and invalidate both the list and the single-record caches.\n *\n * @param resource - The resource name.\n * @param options - Extra TanStack Mutation options.\n * @returns The mutation; `mutate({ id, data })` updates the record.\n */\nexport function useUpdate<T>(\n    resource: string,\n    options?: UseUpdateOptions<T>,\n): UseMutationResult<T, Error, UpdateVariables> {\n    const provider = useDataProvider();\n    const queryClient = useQueryClient();\n    return useMutation<T, Error, UpdateVariables>({\n        mutationFn: ({ id, data }: UpdateVariables) => provider.update<T>(resource, id, data),\n        onSuccess: (...args) => {\n            const [, variables] = args;\n            void queryClient.invalidateQueries({ queryKey: [\"data\", resource, \"list\"] });\n            void queryClient.invalidateQueries({ queryKey: oneQueryKey(resource, variables.id) });\n            options?.onSuccess?.(...args);\n        },\n        ...options,\n    });\n}\n\n/** Options for the delete mutation (mutationFn + onSuccess are provided). */\nexport type UseDeleteOptions<T> = Omit<UseMutationOptions<T, Error, string | number>, \"mutationFn\">;\n\n/**\n * Delete a record by id and invalidate the resource list cache on success.\n *\n * @param resource - The resource name.\n * @param options - Extra TanStack Mutation options.\n * @returns The mutation; `mutate(id)` deletes the record.\n */\nexport function useDelete<T>(\n    resource: string,\n    options?: UseDeleteOptions<T>,\n): UseMutationResult<T, Error, string | number> {\n    const provider = useDataProvider();\n    const queryClient = useQueryClient();\n    return useMutation<T, Error, string | number>({\n        mutationFn: (id: string | number) => provider.deleteOne<T>(resource, id),\n        onSuccess: (...args) => {\n            void queryClient.invalidateQueries({ queryKey: [\"data\", resource, \"list\"] });\n            options?.onSuccess?.(...args);\n        },\n        ...options,\n    });\n}\n"],"names":["listQueryKey","resource","params","oneQueryKey","id","useList","options","provider","useDataProvider","useQuery","useOne","enabled","rest","useCreate","queryClient","useQueryClient","useMutation","data","args","useUpdate","variables","useDelete"],"mappings":"kKAgCO,SAASA,EAAaC,EAAkBC,EAAmC,CAC9E,MAAO,CAAC,OAAQD,EAAU,OAAQC,CAAM,CAC5C,CASO,SAASC,EAAYF,EAAkBG,EAAmD,CAC7F,MAAO,CAAC,OAAQH,EAAU,MAAOG,CAAE,CACvC,CAUO,SAASC,EACZJ,EACAC,EACAI,EACoC,CACpC,MAAMC,EAAWC,EAAAA,gBAAA,EACjB,OAAOC,WAA+B,CAClC,SAAUT,EAAaC,EAAUC,CAAM,EACvC,QAAS,IAAMK,EAAS,QAAWN,EAAUC,CAAM,EACnD,GAAGI,CAAA,CACN,CACL,CAYO,SAASI,EACZT,EACAG,EACAE,EACwB,CACxB,MAAMC,EAAWC,EAAAA,gBAAA,EACX,CAAE,QAAAG,EAAS,GAAGC,CAAA,EAASN,GAAW,CAAA,EACxC,OAAOG,WAAmB,CACtB,SAAUN,EAAYF,EAAUG,CAAE,EAClC,QAAS,IAAMG,EAAS,OAAUN,EAAUG,CAAqB,EACjE,QAASA,GAAM,OAASO,GAAW,IACnC,GAAGC,CAAA,CACN,CACL,CAYO,SAASC,EACZZ,EACAK,EACoC,CACpC,MAAMC,EAAWC,EAAAA,gBAAA,EACXM,EAAcC,EAAAA,eAAA,EACpB,OAAOC,cAA+B,CAClC,WAAaC,GAAkBV,EAAS,OAAUN,EAAUgB,CAAI,EAChE,UAAW,IAAIC,IAAS,CACfJ,EAAY,kBAAkB,CAAE,SAAU,CAAC,OAAQb,EAAU,MAAM,EAAG,EAC3EK,GAAS,YAAY,GAAGY,CAAI,CAChC,EACA,GAAGZ,CAAA,CACN,CACL,CAoBO,SAASa,EACZlB,EACAK,EAC4C,CAC5C,MAAMC,EAAWC,EAAAA,gBAAA,EACXM,EAAcC,EAAAA,eAAA,EACpB,OAAOC,cAAuC,CAC1C,WAAY,CAAC,CAAE,GAAAZ,EAAI,KAAAa,CAAA,IAA4BV,EAAS,OAAUN,EAAUG,EAAIa,CAAI,EACpF,UAAW,IAAIC,IAAS,CACpB,KAAM,CAAA,CAAGE,CAAS,EAAIF,EACjBJ,EAAY,kBAAkB,CAAE,SAAU,CAAC,OAAQb,EAAU,MAAM,EAAG,EACtEa,EAAY,kBAAkB,CAAE,SAAUX,EAAYF,EAAUmB,EAAU,EAAE,EAAG,EACpFd,GAAS,YAAY,GAAGY,CAAI,CAChC,EACA,GAAGZ,CAAA,CACN,CACL,CAYO,SAASe,EACZpB,EACAK,EAC4C,CAC5C,MAAMC,EAAWC,EAAAA,gBAAA,EACXM,EAAcC,EAAAA,eAAA,EACpB,OAAOC,cAAuC,CAC1C,WAAaZ,GAAwBG,EAAS,UAAaN,EAAUG,CAAE,EACvE,UAAW,IAAIc,IAAS,CACfJ,EAAY,kBAAkB,CAAE,SAAU,CAAC,OAAQb,EAAU,MAAM,EAAG,EAC3EK,GAAS,YAAY,GAAGY,CAAI,CAChC,EACA,GAAGZ,CAAA,CACN,CACL"}
+{"version":3,"file":"use-resource.cjs","names":[],"sources":["../../src/data/use-resource.ts"],"sourcesContent":["import { useMutation, useQuery, useQueryClient } from \"@tanstack/react-query\";\nimport type {\n    UseMutationOptions,\n    UseMutationResult,\n    UseQueryOptions,\n    UseQueryResult,\n} from \"@tanstack/react-query\";\n\nimport type { OffsetPage } from \"@/query/pagination\";\n\nimport type { GetListParams } from \"./create-data-provider\";\nimport { useDataProvider } from \"./data-provider-context\";\n\n/** Extra TanStack Query options for {@link useList} (key + fn are provided). */\nexport type UseListOptions<T> = Omit<\n    UseQueryOptions<OffsetPage<T>, Error, OffsetPage<T>>,\n    \"queryKey\" | \"queryFn\"\n>;\n\n/** Extra TanStack Query options for {@link useOne} (key + fn + enabled are provided). */\nexport type UseOneOptions<T> = Omit<\n    UseQueryOptions<T, Error, T>,\n    \"queryKey\" | \"queryFn\" | \"enabled\"\n> & { enabled?: boolean };\n\n/**\n * Build the cache key for a resource list query.\n *\n * @param resource - The resource name.\n * @param params - The list params (page/sort/filters).\n * @returns A stable TanStack Query key.\n */\nexport function listQueryKey(resource: string, params?: GetListParams): unknown[] {\n    return [\"data\", resource, \"list\", params];\n}\n\n/**\n * Build the cache key for a single-record query.\n *\n * @param resource - The resource name.\n * @param id - The record id.\n * @returns A stable TanStack Query key.\n */\nexport function oneQueryKey(resource: string, id: string | number | null | undefined): unknown[] {\n    return [\"data\", resource, \"one\", id];\n}\n\n/**\n * Query a paginated list of a resource through the active {@link useDataProvider}.\n *\n * @param resource - The resource name.\n * @param params - Pagination, sort and filter parameters.\n * @param options - Extra TanStack Query options.\n * @returns The TanStack Query result for the offset page.\n */\nexport function useList<T>(\n    resource: string,\n    params?: GetListParams,\n    options?: UseListOptions<T>,\n): UseQueryResult<OffsetPage<T>, Error> {\n    const provider = useDataProvider();\n    return useQuery<OffsetPage<T>, Error>({\n        queryKey: listQueryKey(resource, params),\n        queryFn: () => provider.getList<T>(resource, params),\n        ...options,\n    });\n}\n\n/**\n * Query a single record by id through the active {@link useDataProvider}.\n *\n * The query is disabled while `id` is `null`/`undefined`.\n *\n * @param resource - The resource name.\n * @param id - The record id.\n * @param options - Extra TanStack Query options.\n * @returns The TanStack Query result for the record.\n */\nexport function useOne<T>(\n    resource: string,\n    id: string | number | null | undefined,\n    options?: UseOneOptions<T>,\n): UseQueryResult<T, Error> {\n    const provider = useDataProvider();\n    const { enabled, ...rest } = options ?? {};\n    return useQuery<T, Error>({\n        queryKey: oneQueryKey(resource, id),\n        queryFn: () => provider.getOne<T>(resource, id as string | number),\n        enabled: id != null && (enabled ?? true),\n        ...rest,\n    });\n}\n\n/** Options for the create mutation (mutationFn + onSuccess are provided). */\nexport type UseCreateOptions<T> = Omit<UseMutationOptions<T, Error, unknown>, \"mutationFn\">;\n\n/**\n * Create a record and invalidate the resource list cache on success.\n *\n * @param resource - The resource name.\n * @param options - Extra TanStack Mutation options.\n * @returns The mutation; `mutate(data)` creates the record.\n */\nexport function useCreate<T>(\n    resource: string,\n    options?: UseCreateOptions<T>,\n): UseMutationResult<T, Error, unknown> {\n    const provider = useDataProvider();\n    const queryClient = useQueryClient();\n    return useMutation<T, Error, unknown>({\n        mutationFn: (data: unknown) => provider.create<T>(resource, data),\n        onSuccess: (...args) => {\n            void queryClient.invalidateQueries({ queryKey: [\"data\", resource, \"list\"] });\n            options?.onSuccess?.(...args);\n        },\n        ...options,\n    });\n}\n\n/** Variables accepted by the update mutation. */\nexport interface UpdateVariables {\n    /** The record id to update. */\n    id: string | number;\n    /** The update payload. */\n    data: unknown;\n}\n\n/** Options for the update mutation (mutationFn + onSuccess are provided). */\nexport type UseUpdateOptions<T> = Omit<UseMutationOptions<T, Error, UpdateVariables>, \"mutationFn\">;\n\n/**\n * Update a record and invalidate both the list and the single-record caches.\n *\n * @param resource - The resource name.\n * @param options - Extra TanStack Mutation options.\n * @returns The mutation; `mutate({ id, data })` updates the record.\n */\nexport function useUpdate<T>(\n    resource: string,\n    options?: UseUpdateOptions<T>,\n): UseMutationResult<T, Error, UpdateVariables> {\n    const provider = useDataProvider();\n    const queryClient = useQueryClient();\n    return useMutation<T, Error, UpdateVariables>({\n        mutationFn: ({ id, data }: UpdateVariables) => provider.update<T>(resource, id, data),\n        onSuccess: (...args) => {\n            const [, variables] = args;\n            void queryClient.invalidateQueries({ queryKey: [\"data\", resource, \"list\"] });\n            void queryClient.invalidateQueries({ queryKey: oneQueryKey(resource, variables.id) });\n            options?.onSuccess?.(...args);\n        },\n        ...options,\n    });\n}\n\n/** Options for the delete mutation (mutationFn + onSuccess are provided). */\nexport type UseDeleteOptions<T> = Omit<UseMutationOptions<T, Error, string | number>, \"mutationFn\">;\n\n/**\n * Delete a record by id and invalidate the resource list cache on success.\n *\n * @param resource - The resource name.\n * @param options - Extra TanStack Mutation options.\n * @returns The mutation; `mutate(id)` deletes the record.\n */\nexport function useDelete<T>(\n    resource: string,\n    options?: UseDeleteOptions<T>,\n): UseMutationResult<T, Error, string | number> {\n    const provider = useDataProvider();\n    const queryClient = useQueryClient();\n    return useMutation<T, Error, string | number>({\n        mutationFn: (id: string | number) => provider.deleteOne<T>(resource, id),\n        onSuccess: (...args) => {\n            void queryClient.invalidateQueries({ queryKey: [\"data\", resource, \"list\"] });\n            options?.onSuccess?.(...args);\n        },\n        ...options,\n    });\n}\n"],"mappings":"sFAgCA,SAAgB,EAAa,EAAkB,EAAmC,CAC9E,MAAO,CAAC,OAAQ,EAAU,OAAQ,CAAM,CAC5C,CASA,SAAgB,EAAY,EAAkB,EAAmD,CAC7F,MAAO,CAAC,OAAQ,EAAU,MAAO,CAAE,CACvC,CAUA,SAAgB,EACZ,EACA,EACA,EACoC,CACpC,IAAM,EAAW,EAAA,gBAAgB,EACjC,OAAA,EAAA,EAAA,SAAA,CAAsC,CAClC,SAAU,EAAa,EAAU,CAAM,EACvC,YAAe,EAAS,QAAW,EAAU,CAAM,EACnD,GAAG,CACP,CAAC,CACL,CAYA,SAAgB,EACZ,EACA,EACA,EACwB,CACxB,IAAM,EAAW,EAAA,gBAAgB,EAC3B,CAAE,UAAS,GAAG,GAAS,GAAW,CAAC,EACzC,OAAA,EAAA,EAAA,SAAA,CAA0B,CACtB,SAAU,EAAY,EAAU,CAAE,EAClC,YAAe,EAAS,OAAU,EAAU,CAAqB,EACjE,QAAS,GAAM,OAAS,GAAW,IACnC,GAAG,CACP,CAAC,CACL,CAYA,SAAgB,EACZ,EACA,EACoC,CACpC,IAAM,EAAW,EAAA,gBAAgB,EAC3B,GAAA,EAAA,EAAA,eAAA,CAA6B,EACnC,OAAA,EAAA,EAAA,YAAA,CAAsC,CAClC,WAAa,GAAkB,EAAS,OAAU,EAAU,CAAI,EAChE,WAAY,GAAG,IAAS,CACpB,EAAiB,kBAAkB,CAAE,SAAU,CAAC,OAAQ,EAAU,MAAM,CAAE,CAAC,EAC3E,GAAS,YAAY,GAAG,CAAI,CAChC,EACA,GAAG,CACP,CAAC,CACL,CAoBA,SAAgB,EACZ,EACA,EAC4C,CAC5C,IAAM,EAAW,EAAA,gBAAgB,EAC3B,GAAA,EAAA,EAAA,eAAA,CAA6B,EACnC,OAAA,EAAA,EAAA,YAAA,CAA8C,CAC1C,YAAa,CAAE,KAAI,UAA4B,EAAS,OAAU,EAAU,EAAI,CAAI,EACpF,WAAY,GAAG,IAAS,CACpB,GAAM,EAAG,GAAa,EACtB,EAAiB,kBAAkB,CAAE,SAAU,CAAC,OAAQ,EAAU,MAAM,CAAE,CAAC,EAC3E,EAAiB,kBAAkB,CAAE,SAAU,EAAY,EAAU,EAAU,EAAE,CAAE,CAAC,EACpF,GAAS,YAAY,GAAG,CAAI,CAChC,EACA,GAAG,CACP,CAAC,CACL,CAYA,SAAgB,EACZ,EACA,EAC4C,CAC5C,IAAM,EAAW,EAAA,gBAAgB,EAC3B,GAAA,EAAA,EAAA,eAAA,CAA6B,EACnC,OAAA,EAAA,EAAA,YAAA,CAA8C,CAC1C,WAAa,GAAwB,EAAS,UAAa,EAAU,CAAE,EACvE,WAAY,GAAG,IAAS,CACpB,EAAiB,kBAAkB,CAAE,SAAU,CAAC,OAAQ,EAAU,MAAM,CAAE,CAAC,EAC3E,GAAS,YAAY,GAAG,CAAI,CAChC,EACA,GAAG,CACP,CAAC,CACL"}

package/dist/data/use-resource.js

@@ -1,66 +1,83 @@
-import { useQueryClient as o, useMutation as a, useQuery as c } from "@tanstack/react-query";
-import { useDataProvider as s } from "./data-provider-context.js";
-function y(e, t) {
-  return ["data", e, "list", t];
+import { useDataProvider as e } from "./data-provider-context.js";
+import { useMutation as t, useQuery as n, useQueryClient as r } from "@tanstack/react-query";
+//#region src/data/use-resource.ts
+function i(e, t) {
+	return [
+		"data",
+		e,
+		"list",
+		t
+	];
 }
-function d(e, t) {
-  return ["data", e, "one", t];
+function a(e, t) {
+	return [
+		"data",
+		e,
+		"one",
+		t
+	];
 }
-function q(e, t, i) {
-  const u = s();
-  return c({
-    queryKey: y(e, t),
-    queryFn: () => u.getList(e, t),
-    ...i
-  });
+function o(t, r, a) {
+	let o = e();
+	return n({
+		queryKey: i(t, r),
+		queryFn: () => o.getList(t, r),
+		...a
+	});
 }
-function f(e, t, i) {
-  const u = s(), { enabled: n, ...r } = i ?? {};
-  return c({
-    queryKey: d(e, t),
-    queryFn: () => u.getOne(e, t),
-    enabled: t != null && (n ?? !0),
-    ...r
-  });
+function s(t, r, i) {
+	let o = e(), { enabled: s, ...c } = i ?? {};
+	return n({
+		queryKey: a(t, r),
+		queryFn: () => o.getOne(t, r),
+		enabled: r != null && (s ?? !0),
+		...c
+	});
 }
-function K(e, t) {
-  const i = s(), u = o();
-  return a({
-    mutationFn: (n) => i.create(e, n),
-    onSuccess: (...n) => {
-      u.invalidateQueries({ queryKey: ["data", e, "list"] }), t?.onSuccess?.(...n);
-    },
-    ...t
-  });
+function c(n, i) {
+	let a = e(), o = r();
+	return t({
+		mutationFn: (e) => a.create(n, e),
+		onSuccess: (...e) => {
+			o.invalidateQueries({ queryKey: [
+				"data",
+				n,
+				"list"
+			] }), i?.onSuccess?.(...e);
+		},
+		...i
+	});
 }
-function Q(e, t) {
-  const i = s(), u = o();
-  return a({
-    mutationFn: ({ id: n, data: r }) => i.update(e, n, r),
-    onSuccess: (...n) => {
-      const [, r] = n;
-      u.invalidateQueries({ queryKey: ["data", e, "list"] }), u.invalidateQueries({ queryKey: d(e, r.id) }), t?.onSuccess?.(...n);
-    },
-    ...t
-  });
+function l(n, i) {
+	let o = e(), s = r();
+	return t({
+		mutationFn: ({ id: e, data: t }) => o.update(n, e, t),
+		onSuccess: (...e) => {
+			let [, t] = e;
+			s.invalidateQueries({ queryKey: [
+				"data",
+				n,
+				"list"
+			] }), s.invalidateQueries({ queryKey: a(n, t.id) }), i?.onSuccess?.(...e);
+		},
+		...i
+	});
 }
-function m(e, t) {
-  const i = s(), u = o();
-  return a({
-    mutationFn: (n) => i.deleteOne(e, n),
-    onSuccess: (...n) => {
-      u.invalidateQueries({ queryKey: ["data", e, "list"] }), t?.onSuccess?.(...n);
-    },
-    ...t
-  });
+function u(n, i) {
+	let a = e(), o = r();
+	return t({
+		mutationFn: (e) => a.deleteOne(n, e),
+		onSuccess: (...e) => {
+			o.invalidateQueries({ queryKey: [
+				"data",
+				n,
+				"list"
+			] }), i?.onSuccess?.(...e);
+		},
+		...i
+	});
 }
-export {
-  y as listQueryKey,
-  d as oneQueryKey,
-  K as useCreate,
-  m as useDelete,
-  q as useList,
-  f as useOne,
-  Q as useUpdate
-};
-//# sourceMappingURL=use-resource.js.map
+//#endregion
+export { i as listQueryKey, a as oneQueryKey, c as useCreate, u as useDelete, o as useList, s as useOne, l as useUpdate };
+
+//# sourceMappingURL=use-resource.js.map

package/dist/data/use-resource.js.map

@@ -1 +1 @@
-{"version":3,"file":"use-resource.js","sources":["../../src/data/use-resource.ts"],"sourcesContent":["import { useMutation, useQuery, useQueryClient } from \"@tanstack/react-query\";\nimport type {\n    UseMutationOptions,\n    UseMutationResult,\n    UseQueryOptions,\n    UseQueryResult,\n} from \"@tanstack/react-query\";\n\nimport type { OffsetPage } from \"@/query/pagination\";\n\nimport type { GetListParams } from \"./create-data-provider\";\nimport { useDataProvider } from \"./data-provider-context\";\n\n/** Extra TanStack Query options for {@link useList} (key + fn are provided). */\nexport type UseListOptions<T> = Omit<\n    UseQueryOptions<OffsetPage<T>, Error, OffsetPage<T>>,\n    \"queryKey\" | \"queryFn\"\n>;\n\n/** Extra TanStack Query options for {@link useOne} (key + fn + enabled are provided). */\nexport type UseOneOptions<T> = Omit<\n    UseQueryOptions<T, Error, T>,\n    \"queryKey\" | \"queryFn\" | \"enabled\"\n> & { enabled?: boolean };\n\n/**\n * Build the cache key for a resource list query.\n *\n * @param resource - The resource name.\n * @param params - The list params (page/sort/filters).\n * @returns A stable TanStack Query key.\n */\nexport function listQueryKey(resource: string, params?: GetListParams): unknown[] {\n    return [\"data\", resource, \"list\", params];\n}\n\n/**\n * Build the cache key for a single-record query.\n *\n * @param resource - The resource name.\n * @param id - The record id.\n * @returns A stable TanStack Query key.\n */\nexport function oneQueryKey(resource: string, id: string | number | null | undefined): unknown[] {\n    return [\"data\", resource, \"one\", id];\n}\n\n/**\n * Query a paginated list of a resource through the active {@link useDataProvider}.\n *\n * @param resource - The resource name.\n * @param params - Pagination, sort and filter parameters.\n * @param options - Extra TanStack Query options.\n * @returns The TanStack Query result for the offset page.\n */\nexport function useList<T>(\n    resource: string,\n    params?: GetListParams,\n    options?: UseListOptions<T>,\n): UseQueryResult<OffsetPage<T>, Error> {\n    const provider = useDataProvider();\n    return useQuery<OffsetPage<T>, Error>({\n        queryKey: listQueryKey(resource, params),\n        queryFn: () => provider.getList<T>(resource, params),\n        ...options,\n    });\n}\n\n/**\n * Query a single record by id through the active {@link useDataProvider}.\n *\n * The query is disabled while `id` is `null`/`undefined`.\n *\n * @param resource - The resource name.\n * @param id - The record id.\n * @param options - Extra TanStack Query options.\n * @returns The TanStack Query result for the record.\n */\nexport function useOne<T>(\n    resource: string,\n    id: string | number | null | undefined,\n    options?: UseOneOptions<T>,\n): UseQueryResult<T, Error> {\n    const provider = useDataProvider();\n    const { enabled, ...rest } = options ?? {};\n    return useQuery<T, Error>({\n        queryKey: oneQueryKey(resource, id),\n        queryFn: () => provider.getOne<T>(resource, id as string | number),\n        enabled: id != null && (enabled ?? true),\n        ...rest,\n    });\n}\n\n/** Options for the create mutation (mutationFn + onSuccess are provided). */\nexport type UseCreateOptions<T> = Omit<UseMutationOptions<T, Error, unknown>, \"mutationFn\">;\n\n/**\n * Create a record and invalidate the resource list cache on success.\n *\n * @param resource - The resource name.\n * @param options - Extra TanStack Mutation options.\n * @returns The mutation; `mutate(data)` creates the record.\n */\nexport function useCreate<T>(\n    resource: string,\n    options?: UseCreateOptions<T>,\n): UseMutationResult<T, Error, unknown> {\n    const provider = useDataProvider();\n    const queryClient = useQueryClient();\n    return useMutation<T, Error, unknown>({\n        mutationFn: (data: unknown) => provider.create<T>(resource, data),\n        onSuccess: (...args) => {\n            void queryClient.invalidateQueries({ queryKey: [\"data\", resource, \"list\"] });\n            options?.onSuccess?.(...args);\n        },\n        ...options,\n    });\n}\n\n/** Variables accepted by the update mutation. */\nexport interface UpdateVariables {\n    /** The record id to update. */\n    id: string | number;\n    /** The update payload. */\n    data: unknown;\n}\n\n/** Options for the update mutation (mutationFn + onSuccess are provided). */\nexport type UseUpdateOptions<T> = Omit<UseMutationOptions<T, Error, UpdateVariables>, \"mutationFn\">;\n\n/**\n * Update a record and invalidate both the list and the single-record caches.\n *\n * @param resource - The resource name.\n * @param options - Extra TanStack Mutation options.\n * @returns The mutation; `mutate({ id, data })` updates the record.\n */\nexport function useUpdate<T>(\n    resource: string,\n    options?: UseUpdateOptions<T>,\n): UseMutationResult<T, Error, UpdateVariables> {\n    const provider = useDataProvider();\n    const queryClient = useQueryClient();\n    return useMutation<T, Error, UpdateVariables>({\n        mutationFn: ({ id, data }: UpdateVariables) => provider.update<T>(resource, id, data),\n        onSuccess: (...args) => {\n            const [, variables] = args;\n            void queryClient.invalidateQueries({ queryKey: [\"data\", resource, \"list\"] });\n            void queryClient.invalidateQueries({ queryKey: oneQueryKey(resource, variables.id) });\n            options?.onSuccess?.(...args);\n        },\n        ...options,\n    });\n}\n\n/** Options for the delete mutation (mutationFn + onSuccess are provided). */\nexport type UseDeleteOptions<T> = Omit<UseMutationOptions<T, Error, string | number>, \"mutationFn\">;\n\n/**\n * Delete a record by id and invalidate the resource list cache on success.\n *\n * @param resource - The resource name.\n * @param options - Extra TanStack Mutation options.\n * @returns The mutation; `mutate(id)` deletes the record.\n */\nexport function useDelete<T>(\n    resource: string,\n    options?: UseDeleteOptions<T>,\n): UseMutationResult<T, Error, string | number> {\n    const provider = useDataProvider();\n    const queryClient = useQueryClient();\n    return useMutation<T, Error, string | number>({\n        mutationFn: (id: string | number) => provider.deleteOne<T>(resource, id),\n        onSuccess: (...args) => {\n            void queryClient.invalidateQueries({ queryKey: [\"data\", resource, \"list\"] });\n            options?.onSuccess?.(...args);\n        },\n        ...options,\n    });\n}\n"],"names":["listQueryKey","resource","params","oneQueryKey","id","useList","options","provider","useDataProvider","useQuery","useOne","enabled","rest","useCreate","queryClient","useQueryClient","useMutation","data","args","useUpdate","variables","useDelete"],"mappings":";;AAgCO,SAASA,EAAaC,GAAkBC,GAAmC;AAC9E,SAAO,CAAC,QAAQD,GAAU,QAAQC,CAAM;AAC5C;AASO,SAASC,EAAYF,GAAkBG,GAAmD;AAC7F,SAAO,CAAC,QAAQH,GAAU,OAAOG,CAAE;AACvC;AAUO,SAASC,EACZJ,GACAC,GACAI,GACoC;AACpC,QAAMC,IAAWC,EAAA;AACjB,SAAOC,EAA+B;AAAA,IAClC,UAAUT,EAAaC,GAAUC,CAAM;AAAA,IACvC,SAAS,MAAMK,EAAS,QAAWN,GAAUC,CAAM;AAAA,IACnD,GAAGI;AAAA,EAAA,CACN;AACL;AAYO,SAASI,EACZT,GACAG,GACAE,GACwB;AACxB,QAAMC,IAAWC,EAAA,GACX,EAAE,SAAAG,GAAS,GAAGC,EAAA,IAASN,KAAW,CAAA;AACxC,SAAOG,EAAmB;AAAA,IACtB,UAAUN,EAAYF,GAAUG,CAAE;AAAA,IAClC,SAAS,MAAMG,EAAS,OAAUN,GAAUG,CAAqB;AAAA,IACjE,SAASA,KAAM,SAASO,KAAW;AAAA,IACnC,GAAGC;AAAA,EAAA,CACN;AACL;AAYO,SAASC,EACZZ,GACAK,GACoC;AACpC,QAAMC,IAAWC,EAAA,GACXM,IAAcC,EAAA;AACpB,SAAOC,EAA+B;AAAA,IAClC,YAAY,CAACC,MAAkBV,EAAS,OAAUN,GAAUgB,CAAI;AAAA,IAChE,WAAW,IAAIC,MAAS;AACpB,MAAKJ,EAAY,kBAAkB,EAAE,UAAU,CAAC,QAAQb,GAAU,MAAM,GAAG,GAC3EK,GAAS,YAAY,GAAGY,CAAI;AAAA,IAChC;AAAA,IACA,GAAGZ;AAAA,EAAA,CACN;AACL;AAoBO,SAASa,EACZlB,GACAK,GAC4C;AAC5C,QAAMC,IAAWC,EAAA,GACXM,IAAcC,EAAA;AACpB,SAAOC,EAAuC;AAAA,IAC1C,YAAY,CAAC,EAAE,IAAAZ,GAAI,MAAAa,EAAA,MAA4BV,EAAS,OAAUN,GAAUG,GAAIa,CAAI;AAAA,IACpF,WAAW,IAAIC,MAAS;AACpB,YAAM,CAAA,EAAGE,CAAS,IAAIF;AACtB,MAAKJ,EAAY,kBAAkB,EAAE,UAAU,CAAC,QAAQb,GAAU,MAAM,GAAG,GACtEa,EAAY,kBAAkB,EAAE,UAAUX,EAAYF,GAAUmB,EAAU,EAAE,GAAG,GACpFd,GAAS,YAAY,GAAGY,CAAI;AAAA,IAChC;AAAA,IACA,GAAGZ;AAAA,EAAA,CACN;AACL;AAYO,SAASe,EACZpB,GACAK,GAC4C;AAC5C,QAAMC,IAAWC,EAAA,GACXM,IAAcC,EAAA;AACpB,SAAOC,EAAuC;AAAA,IAC1C,YAAY,CAACZ,MAAwBG,EAAS,UAAaN,GAAUG,CAAE;AAAA,IACvE,WAAW,IAAIc,MAAS;AACpB,MAAKJ,EAAY,kBAAkB,EAAE,UAAU,CAAC,QAAQb,GAAU,MAAM,GAAG,GAC3EK,GAAS,YAAY,GAAGY,CAAI;AAAA,IAChC;AAAA,IACA,GAAGZ;AAAA,EAAA,CACN;AACL;"}
+{"version":3,"file":"use-resource.js","names":[],"sources":["../../src/data/use-resource.ts"],"sourcesContent":["import { useMutation, useQuery, useQueryClient } from \"@tanstack/react-query\";\nimport type {\n    UseMutationOptions,\n    UseMutationResult,\n    UseQueryOptions,\n    UseQueryResult,\n} from \"@tanstack/react-query\";\n\nimport type { OffsetPage } from \"@/query/pagination\";\n\nimport type { GetListParams } from \"./create-data-provider\";\nimport { useDataProvider } from \"./data-provider-context\";\n\n/** Extra TanStack Query options for {@link useList} (key + fn are provided). */\nexport type UseListOptions<T> = Omit<\n    UseQueryOptions<OffsetPage<T>, Error, OffsetPage<T>>,\n    \"queryKey\" | \"queryFn\"\n>;\n\n/** Extra TanStack Query options for {@link useOne} (key + fn + enabled are provided). */\nexport type UseOneOptions<T> = Omit<\n    UseQueryOptions<T, Error, T>,\n    \"queryKey\" | \"queryFn\" | \"enabled\"\n> & { enabled?: boolean };\n\n/**\n * Build the cache key for a resource list query.\n *\n * @param resource - The resource name.\n * @param params - The list params (page/sort/filters).\n * @returns A stable TanStack Query key.\n */\nexport function listQueryKey(resource: string, params?: GetListParams): unknown[] {\n    return [\"data\", resource, \"list\", params];\n}\n\n/**\n * Build the cache key for a single-record query.\n *\n * @param resource - The resource name.\n * @param id - The record id.\n * @returns A stable TanStack Query key.\n */\nexport function oneQueryKey(resource: string, id: string | number | null | undefined): unknown[] {\n    return [\"data\", resource, \"one\", id];\n}\n\n/**\n * Query a paginated list of a resource through the active {@link useDataProvider}.\n *\n * @param resource - The resource name.\n * @param params - Pagination, sort and filter parameters.\n * @param options - Extra TanStack Query options.\n * @returns The TanStack Query result for the offset page.\n */\nexport function useList<T>(\n    resource: string,\n    params?: GetListParams,\n    options?: UseListOptions<T>,\n): UseQueryResult<OffsetPage<T>, Error> {\n    const provider = useDataProvider();\n    return useQuery<OffsetPage<T>, Error>({\n        queryKey: listQueryKey(resource, params),\n        queryFn: () => provider.getList<T>(resource, params),\n        ...options,\n    });\n}\n\n/**\n * Query a single record by id through the active {@link useDataProvider}.\n *\n * The query is disabled while `id` is `null`/`undefined`.\n *\n * @param resource - The resource name.\n * @param id - The record id.\n * @param options - Extra TanStack Query options.\n * @returns The TanStack Query result for the record.\n */\nexport function useOne<T>(\n    resource: string,\n    id: string | number | null | undefined,\n    options?: UseOneOptions<T>,\n): UseQueryResult<T, Error> {\n    const provider = useDataProvider();\n    const { enabled, ...rest } = options ?? {};\n    return useQuery<T, Error>({\n        queryKey: oneQueryKey(resource, id),\n        queryFn: () => provider.getOne<T>(resource, id as string | number),\n        enabled: id != null && (enabled ?? true),\n        ...rest,\n    });\n}\n\n/** Options for the create mutation (mutationFn + onSuccess are provided). */\nexport type UseCreateOptions<T> = Omit<UseMutationOptions<T, Error, unknown>, \"mutationFn\">;\n\n/**\n * Create a record and invalidate the resource list cache on success.\n *\n * @param resource - The resource name.\n * @param options - Extra TanStack Mutation options.\n * @returns The mutation; `mutate(data)` creates the record.\n */\nexport function useCreate<T>(\n    resource: string,\n    options?: UseCreateOptions<T>,\n): UseMutationResult<T, Error, unknown> {\n    const provider = useDataProvider();\n    const queryClient = useQueryClient();\n    return useMutation<T, Error, unknown>({\n        mutationFn: (data: unknown) => provider.create<T>(resource, data),\n        onSuccess: (...args) => {\n            void queryClient.invalidateQueries({ queryKey: [\"data\", resource, \"list\"] });\n            options?.onSuccess?.(...args);\n        },\n        ...options,\n    });\n}\n\n/** Variables accepted by the update mutation. */\nexport interface UpdateVariables {\n    /** The record id to update. */\n    id: string | number;\n    /** The update payload. */\n    data: unknown;\n}\n\n/** Options for the update mutation (mutationFn + onSuccess are provided). */\nexport type UseUpdateOptions<T> = Omit<UseMutationOptions<T, Error, UpdateVariables>, \"mutationFn\">;\n\n/**\n * Update a record and invalidate both the list and the single-record caches.\n *\n * @param resource - The resource name.\n * @param options - Extra TanStack Mutation options.\n * @returns The mutation; `mutate({ id, data })` updates the record.\n */\nexport function useUpdate<T>(\n    resource: string,\n    options?: UseUpdateOptions<T>,\n): UseMutationResult<T, Error, UpdateVariables> {\n    const provider = useDataProvider();\n    const queryClient = useQueryClient();\n    return useMutation<T, Error, UpdateVariables>({\n        mutationFn: ({ id, data }: UpdateVariables) => provider.update<T>(resource, id, data),\n        onSuccess: (...args) => {\n            const [, variables] = args;\n            void queryClient.invalidateQueries({ queryKey: [\"data\", resource, \"list\"] });\n            void queryClient.invalidateQueries({ queryKey: oneQueryKey(resource, variables.id) });\n            options?.onSuccess?.(...args);\n        },\n        ...options,\n    });\n}\n\n/** Options for the delete mutation (mutationFn + onSuccess are provided). */\nexport type UseDeleteOptions<T> = Omit<UseMutationOptions<T, Error, string | number>, \"mutationFn\">;\n\n/**\n * Delete a record by id and invalidate the resource list cache on success.\n *\n * @param resource - The resource name.\n * @param options - Extra TanStack Mutation options.\n * @returns The mutation; `mutate(id)` deletes the record.\n */\nexport function useDelete<T>(\n    resource: string,\n    options?: UseDeleteOptions<T>,\n): UseMutationResult<T, Error, string | number> {\n    const provider = useDataProvider();\n    const queryClient = useQueryClient();\n    return useMutation<T, Error, string | number>({\n        mutationFn: (id: string | number) => provider.deleteOne<T>(resource, id),\n        onSuccess: (...args) => {\n            void queryClient.invalidateQueries({ queryKey: [\"data\", resource, \"list\"] });\n            options?.onSuccess?.(...args);\n        },\n        ...options,\n    });\n}\n"],"mappings":";;;AAgCA,SAAgB,EAAa,GAAkB,GAAmC;CAC9E,OAAO;EAAC;EAAQ;EAAU;EAAQ;CAAM;AAC5C;AASA,SAAgB,EAAY,GAAkB,GAAmD;CAC7F,OAAO;EAAC;EAAQ;EAAU;EAAO;CAAE;AACvC;AAUA,SAAgB,EACZ,GACA,GACA,GACoC;CACpC,IAAM,IAAW,EAAgB;CACjC,OAAO,EAA+B;EAClC,UAAU,EAAa,GAAU,CAAM;EACvC,eAAe,EAAS,QAAW,GAAU,CAAM;EACnD,GAAG;CACP,CAAC;AACL;AAYA,SAAgB,EACZ,GACA,GACA,GACwB;CACxB,IAAM,IAAW,EAAgB,GAC3B,EAAE,YAAS,GAAG,MAAS,KAAW,CAAC;CACzC,OAAO,EAAmB;EACtB,UAAU,EAAY,GAAU,CAAE;EAClC,eAAe,EAAS,OAAU,GAAU,CAAqB;EACjE,SAAS,KAAM,SAAS,KAAW;EACnC,GAAG;CACP,CAAC;AACL;AAYA,SAAgB,EACZ,GACA,GACoC;CACpC,IAAM,IAAW,EAAgB,GAC3B,IAAc,EAAe;CACnC,OAAO,EAA+B;EAClC,aAAa,MAAkB,EAAS,OAAU,GAAU,CAAI;EAChE,YAAY,GAAG,MAAS;GAEpB,AADA,EAAiB,kBAAkB,EAAE,UAAU;IAAC;IAAQ;IAAU;GAAM,EAAE,CAAC,GAC3E,GAAS,YAAY,GAAG,CAAI;EAChC;EACA,GAAG;CACP,CAAC;AACL;AAoBA,SAAgB,EACZ,GACA,GAC4C;CAC5C,IAAM,IAAW,EAAgB,GAC3B,IAAc,EAAe;CACnC,OAAO,EAAuC;EAC1C,aAAa,EAAE,OAAI,cAA4B,EAAS,OAAU,GAAU,GAAI,CAAI;EACpF,YAAY,GAAG,MAAS;GACpB,IAAM,GAAG,KAAa;GAGtB,AAFA,EAAiB,kBAAkB,EAAE,UAAU;IAAC;IAAQ;IAAU;GAAM,EAAE,CAAC,GAC3E,EAAiB,kBAAkB,EAAE,UAAU,EAAY,GAAU,EAAU,EAAE,EAAE,CAAC,GACpF,GAAS,YAAY,GAAG,CAAI;EAChC;EACA,GAAG;CACP,CAAC;AACL;AAYA,SAAgB,EACZ,GACA,GAC4C;CAC5C,IAAM,IAAW,EAAgB,GAC3B,IAAc,EAAe;CACnC,OAAO,EAAuC;EAC1C,aAAa,MAAwB,EAAS,UAAa,GAAU,CAAE;EACvE,YAAY,GAAG,MAAS;GAEpB,AADA,EAAiB,kBAAkB,EAAE,UAAU;IAAC;IAAQ;IAAU;GAAM,EAAE,CAAC,GAC3E,GAAS,YAAY,GAAG,CAAI;EAChC;EACA,GAAG;CACP,CAAC;AACL"}

package/dist/editor/RichTextEditor.cjs

@@ -1,2 +1,2 @@
-"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const t=require("react/jsx-runtime"),c=require("react"),l=require("@tiptap/react"),g=require("@tiptap/starter-kit"),i=require("lucide-react"),s=require("../utils/cn.cjs"),a=require("./RichTextEditor.module.css.cjs");function v({value:n,onChange:o,placeholder:d,editable:r=!0,toolbar:u=!0,className:b}){const e=l.useEditor({extensions:[g],content:n,editable:r,onUpdate:({editor:x})=>o(x.getHTML())});if(c.useEffect(()=>{e&&n!==e.getHTML()&&e.commands.setContent(n,{emitUpdate:!1})},[e,n]),c.useEffect(()=>{e&&e.setEditable(r)},[e,r]),!e)return null;const f=e.can().chain().focus().undo().run(),h=e.can().chain().focus().redo().run();return t.jsxs("div",{className:s.cn(a.default.wrapper,b),children:[u&&t.jsxs("div",{className:a.default.toolbar,role:"toolbar","aria-label":"Formatação de texto",children:[t.jsx("button",{type:"button",className:s.cn(a.default.button,e.isActive("bold")&&a.default.active),"aria-label":"Negrito","aria-pressed":e.isActive("bold"),onClick:()=>e.chain().focus().toggleBold().run(),children:t.jsx(i.Bold,{size:16,"aria-hidden":!0})}),t.jsx("button",{type:"button",className:s.cn(a.default.button,e.isActive("italic")&&a.default.active),"aria-label":"Itálico","aria-pressed":e.isActive("italic"),onClick:()=>e.chain().focus().toggleItalic().run(),children:t.jsx(i.Italic,{size:16,"aria-hidden":!0})}),t.jsx("button",{type:"button",className:s.cn(a.default.button,e.isActive("strike")&&a.default.active),"aria-label":"Tachado","aria-pressed":e.isActive("strike"),onClick:()=>e.chain().focus().toggleStrike().run(),children:t.jsx(i.Strikethrough,{size:16,"aria-hidden":!0})}),t.jsx("button",{type:"button",className:s.cn(a.default.button,e.isActive("code")&&a.default.active),"aria-label":"Código","aria-pressed":e.isActive("code"),onClick:()=>e.chain().focus().toggleCode().run(),children:t.jsx(i.Code,{size:16,"aria-hidden":!0})}),t.jsx("span",{className:a.default.separator,"aria-hidden":!0}),t.jsx("button",{type:"button",className:s.cn(a.default.button,e.isActive("heading",{level:1})&&a.default.active),"aria-label":"Título 1","aria-pressed":e.isActive("heading",{level:1}),onClick:()=>e.chain().focus().toggleHeading({level:1}).run(),children:t.jsx(i.Heading1,{size:16,"aria-hidden":!0})}),t.jsx("button",{type:"button",className:s.cn(a.default.button,e.isActive("heading",{level:2})&&a.default.active),"aria-label":"Título 2","aria-pressed":e.isActive("heading",{level:2}),onClick:()=>e.chain().focus().toggleHeading({level:2}).run(),children:t.jsx(i.Heading2,{size:16,"aria-hidden":!0})}),t.jsx("span",{className:a.default.separator,"aria-hidden":!0}),t.jsx("button",{type:"button",className:s.cn(a.default.button,e.isActive("bulletList")&&a.default.active),"aria-label":"Lista com marcadores","aria-pressed":e.isActive("bulletList"),onClick:()=>e.chain().focus().toggleBulletList().run(),children:t.jsx(i.List,{size:16,"aria-hidden":!0})}),t.jsx("button",{type:"button",className:s.cn(a.default.button,e.isActive("orderedList")&&a.default.active),"aria-label":"Lista numerada","aria-pressed":e.isActive("orderedList"),onClick:()=>e.chain().focus().toggleOrderedList().run(),children:t.jsx(i.ListOrdered,{size:16,"aria-hidden":!0})}),t.jsx("button",{type:"button",className:s.cn(a.default.button,e.isActive("blockquote")&&a.default.active),"aria-label":"Citação","aria-pressed":e.isActive("blockquote"),onClick:()=>e.chain().focus().toggleBlockquote().run(),children:t.jsx(i.Quote,{size:16,"aria-hidden":!0})}),t.jsx("span",{className:a.default.separator,"aria-hidden":!0}),t.jsx("button",{type:"button",className:a.default.button,"aria-label":"Desfazer",disabled:!f,onClick:()=>e.chain().focus().undo().run(),children:t.jsx(i.Undo2,{size:16,"aria-hidden":!0})}),t.jsx("button",{type:"button",className:a.default.button,"aria-label":"Refazer",disabled:!h,onClick:()=>e.chain().focus().redo().run(),children:t.jsx(i.Redo2,{size:16,"aria-hidden":!0})})]}),t.jsx(l.EditorContent,{editor:e,className:a.default.content,"data-placeholder":d})]})}exports.RichTextEditor=v;
-//# sourceMappingURL=RichTextEditor.cjs.map
+const e=require("../_virtual/_rolldown/runtime.cjs"),t=require("../utils/cn.cjs"),n=require("./RichTextEditor.module.cjs");let r=require("react"),i=require("react/jsx-runtime"),a=require("lucide-react"),o=require("@tiptap/react"),s=require("@tiptap/starter-kit");s=e.__toESM(s,1);function c({value:e,onChange:c,placeholder:l,editable:u=!0,toolbar:d=!0,className:f}){let p=(0,o.useEditor)({extensions:[s.default],content:e,editable:u,onUpdate:({editor:e})=>c(e.getHTML())});(0,r.useEffect)(()=>{p&&e!==p.getHTML()&&p.commands.setContent(e,{emitUpdate:!1})},[p,e]),(0,r.useEffect)(()=>{p&&p.setEditable(u)},[p,u]);let m=(0,o.useEditorState)({editor:p,selector:({editor:e})=>({bold:e.isActive(`bold`),italic:e.isActive(`italic`),strike:e.isActive(`strike`),code:e.isActive(`code`),heading1:e.isActive(`heading`,{level:1}),heading2:e.isActive(`heading`,{level:2}),bulletList:e.isActive(`bulletList`),orderedList:e.isActive(`orderedList`),blockquote:e.isActive(`blockquote`),canUndo:e.can().chain().focus().undo().run(),canRedo:e.can().chain().focus().redo().run()})});if(!p||!m)return null;let h=m.canUndo,g=m.canRedo;return(0,i.jsxs)(`div`,{className:t.cn(n.default.wrapper,f),children:[d&&(0,i.jsxs)(`div`,{className:n.default.toolbar,role:`toolbar`,"aria-label":`Formatação de texto`,children:[(0,i.jsx)(`button`,{type:`button`,className:t.cn(n.default.button,m.bold&&n.default.active),"aria-label":`Negrito`,"aria-pressed":m.bold,onClick:()=>p.chain().focus().toggleBold().run(),children:(0,i.jsx)(a.Bold,{size:16,"aria-hidden":!0})}),(0,i.jsx)(`button`,{type:`button`,className:t.cn(n.default.button,m.italic&&n.default.active),"aria-label":`Itálico`,"aria-pressed":m.italic,onClick:()=>p.chain().focus().toggleItalic().run(),children:(0,i.jsx)(a.Italic,{size:16,"aria-hidden":!0})}),(0,i.jsx)(`button`,{type:`button`,className:t.cn(n.default.button,m.strike&&n.default.active),"aria-label":`Tachado`,"aria-pressed":m.strike,onClick:()=>p.chain().focus().toggleStrike().run(),children:(0,i.jsx)(a.Strikethrough,{size:16,"aria-hidden":!0})}),(0,i.jsx)(`button`,{type:`button`,className:t.cn(n.default.button,m.code&&n.default.active),"aria-label":`Código`,"aria-pressed":m.code,onClick:()=>p.chain().focus().toggleCode().run(),children:(0,i.jsx)(a.Code,{size:16,"aria-hidden":!0})}),(0,i.jsx)(`span`,{className:n.default.separator,"aria-hidden":!0}),(0,i.jsx)(`button`,{type:`button`,className:t.cn(n.default.button,m.heading1&&n.default.active),"aria-label":`Título 1`,"aria-pressed":m.heading1,onClick:()=>p.chain().focus().toggleHeading({level:1}).run(),children:(0,i.jsx)(a.Heading1,{size:16,"aria-hidden":!0})}),(0,i.jsx)(`button`,{type:`button`,className:t.cn(n.default.button,m.heading2&&n.default.active),"aria-label":`Título 2`,"aria-pressed":m.heading2,onClick:()=>p.chain().focus().toggleHeading({level:2}).run(),children:(0,i.jsx)(a.Heading2,{size:16,"aria-hidden":!0})}),(0,i.jsx)(`span`,{className:n.default.separator,"aria-hidden":!0}),(0,i.jsx)(`button`,{type:`button`,className:t.cn(n.default.button,m.bulletList&&n.default.active),"aria-label":`Lista com marcadores`,"aria-pressed":m.bulletList,onClick:()=>p.chain().focus().toggleBulletList().run(),children:(0,i.jsx)(a.List,{size:16,"aria-hidden":!0})}),(0,i.jsx)(`button`,{type:`button`,className:t.cn(n.default.button,m.orderedList&&n.default.active),"aria-label":`Lista numerada`,"aria-pressed":m.orderedList,onClick:()=>p.chain().focus().toggleOrderedList().run(),children:(0,i.jsx)(a.ListOrdered,{size:16,"aria-hidden":!0})}),(0,i.jsx)(`button`,{type:`button`,className:t.cn(n.default.button,m.blockquote&&n.default.active),"aria-label":`Citação`,"aria-pressed":m.blockquote,onClick:()=>p.chain().focus().toggleBlockquote().run(),children:(0,i.jsx)(a.Quote,{size:16,"aria-hidden":!0})}),(0,i.jsx)(`span`,{className:n.default.separator,"aria-hidden":!0}),(0,i.jsx)(`button`,{type:`button`,className:n.default.button,"aria-label":`Desfazer`,disabled:!h,onClick:()=>p.chain().focus().undo().run(),children:(0,i.jsx)(a.Undo2,{size:16,"aria-hidden":!0})}),(0,i.jsx)(`button`,{type:`button`,className:n.default.button,"aria-label":`Refazer`,disabled:!g,onClick:()=>p.chain().focus().redo().run(),children:(0,i.jsx)(a.Redo2,{size:16,"aria-hidden":!0})})]}),(0,i.jsx)(o.EditorContent,{editor:p,className:n.default.content,"data-placeholder":l})]})}exports.RichTextEditor=c;
+//# sourceMappingURL=RichTextEditor.cjs.map