@sales-planner/react 0.2.0

package/README.md

@@ -0,0 +1,129 @@
+# @sales-planner/react
+
+React hooks for the Sales Planner API, powered by [TanStack Query](https://tanstack.com/query).
+
+## Installation
+
+```bash
+pnpm add @sales-planner/react @tanstack/react-query
+```
+
+## Setup
+
+```tsx
+import { QueryClient, QueryClientProvider } from '@tanstack/react-query';
+import { SalesPlannerProvider } from '@sales-planner/react';
+
+const queryClient = new QueryClient();
+
+function App() {
+  return (
+    <QueryClientProvider client={queryClient}>
+      <SalesPlannerProvider config={{ baseUrl: '/api', apiKey: 'your-key' }}>
+        <MyApp />
+      </SalesPlannerProvider>
+    </QueryClientProvider>
+  );
+}
+```
+
+## Usage
+
+### Queries
+
+```tsx
+import { skus, brands, useMe } from '@sales-planner/react';
+
+function SkuList() {
+  const ctx = { shopId: 1, tenantId: 1 };
+  const { data, isLoading } = skus.useList(ctx, { limit: 20 });
+
+  if (isLoading) return <div>Loading...</div>;
+
+  return (
+    <ul>
+      {data?.items.map((sku) => (
+        <li key={sku.id}>{sku.title}</li>
+      ))}
+    </ul>
+  );
+}
+```
+
+### Mutations
+
+```tsx
+import { brands } from '@sales-planner/react';
+
+function CreateBrand() {
+  const ctx = { shopId: 1, tenantId: 1 };
+  const create = brands.useCreate(ctx);
+
+  return (
+    <button onClick={() => create.mutate({ code: 'NIKE', title: 'Nike' })}>
+      Create Brand
+    </button>
+  );
+}
+```
+
+### CSV Import
+
+```tsx
+import { suppliers } from '@sales-planner/react';
+
+function ImportSuppliers() {
+  const ctx = { shopId: 1, tenantId: 1 };
+  const importCsv = suppliers.useImportCsv(ctx);
+
+  const handleFileUpload = (file: File) => {
+    file.text().then((csv) => importCsv.mutate(csv));
+  };
+
+  return <input type="file" onChange={(e) => handleFileUpload(e.target.files![0]!)} />;
+}
+```
+
+## Available Hooks
+
+### Coded entities
+
+`brands`, `categories`, `groups`, `statuses`, `suppliers`, `warehouses`, `marketplaces`, `skus` — each provides:
+
+- `.useList(ctx, query?)` — paginated list
+- `.useById(ctx, id)` — single entity
+- `.useByCode(ctx, code)` — lookup by code
+- `.useCreate(ctx)` — create mutation
+- `.useUpdate(ctx)` — update mutation (`{ id, data }`)
+- `.useDelete(ctx)` — delete mutation
+- `.useImportJson(ctx)` — JSON import mutation
+- `.useImportCsv(ctx)` — CSV import mutation
+- `.useExportJson(ctx)` — JSON export (manual trigger)
+- `.useExportCsv(ctx)` — CSV export (manual trigger)
+
+### Shop-scoped entities
+
+`salesHistory`, `leftovers`, `seasonalCoefficients`, `skuCompetitorMappings`, `competitorProducts`, `competitorSales` — same as above minus `useByCode`.
+
+### Specialized
+
+- `useMe()` — current user
+- `useEntitiesMetadata()` — entity field metadata
+- `useSkuMetrics(ctx, query?)` — paginated SKU metrics
+- `useSkuMetricsById(ctx, id)` — single SKU metric
+- `useSkuMetricsByAbcClass(ctx, 'A' | 'B' | 'C')` — filter by ABC class
+- `useSkuMetricsExportCsv(ctx)` — CSV export
+- `useComputedViews(ctx)` — list materialized views
+- `useRefreshAllViews(ctx)` — refresh all views mutation
+
+## Cache Invalidation
+
+All mutations automatically invalidate related query caches. The `queryKeys` object is exported for custom cache management:
+
+```tsx
+import { queryKeys } from '@sales-planner/react';
+import { useQueryClient } from '@tanstack/react-query';
+
+const queryClient = useQueryClient();
+queryClient.invalidateQueries({ queryKey: queryKeys.entity('skus', ctx) });
+```

package/dist/coded-entities.d.ts

@@ -0,0 +1,128 @@
+import type { Brand, Category, Group, Status, Supplier, Warehouse, Marketplace } from '@sales-planner/shared';
+export declare const brands: {
+    useList: (ctx: import("./keys.js").ShopContext, query?: import("@sales-planner/shared").PaginationQuery, options?: Omit<import("@tanstack/react-query").UseQueryOptions<import("@sales-planner/shared").PaginatedResponse<Brand>, Error, import("@sales-planner/shared").PaginatedResponse<Brand>, readonly unknown[]>, "queryKey" | "queryFn"> | undefined) => import("@tanstack/react-query").UseQueryResult<import("@sales-planner/shared").PaginatedResponse<Brand>, Error>;
+    useById: (ctx: import("./keys.js").ShopContext, id: number, options?: Omit<import("@tanstack/react-query").UseQueryOptions<Brand, Error, Brand, readonly unknown[]>, "queryKey" | "queryFn"> | undefined) => import("@tanstack/react-query").UseQueryResult<Brand, Error>;
+    useByCode: (ctx: import("./keys.js").ShopContext, code: string, options?: Omit<import("@tanstack/react-query").UseQueryOptions<Brand, Error, Brand, readonly unknown[]>, "queryKey" | "queryFn"> | undefined) => import("@tanstack/react-query").UseQueryResult<Brand, Error>;
+    useExportJson: (ctx: import("./keys.js").ShopContext, options?: Omit<import("@tanstack/react-query").UseQueryOptions<import("@sales-planner/shared").CodedTitledItem[], Error, import("@sales-planner/shared").CodedTitledItem[], readonly unknown[]>, "queryKey" | "queryFn"> | undefined) => import("@tanstack/react-query").UseQueryResult<import("@sales-planner/shared").CodedTitledItem[], Error>;
+    useExportCsv: (ctx: import("./keys.js").ShopContext, options?: Omit<import("@tanstack/react-query").UseQueryOptions<string>, "queryKey" | "queryFn">) => import("@tanstack/react-query").UseQueryResult<string, Error>;
+    useCreate: (ctx: import("./keys.js").ShopContext, options?: Omit<import("@tanstack/react-query").UseMutationOptions<Brand, Error, import("@sales-planner/shared").CodedTitledItem, unknown>, "mutationFn"> | undefined) => import("@tanstack/react-query").UseMutationResult<Brand, Error, import("@sales-planner/shared").CodedTitledItem, unknown>;
+    useUpdate: (ctx: import("./keys.js").ShopContext, options?: Omit<import("@tanstack/react-query").UseMutationOptions<Brand, Error, {
+        id: number;
+        data: import("@sales-planner/shared").CodedTitledUpdateDto;
+    }, unknown>, "mutationFn"> | undefined) => import("@tanstack/react-query").UseMutationResult<Brand, Error, {
+        id: number;
+        data: import("@sales-planner/shared").CodedTitledUpdateDto;
+    }, unknown>;
+    useDelete: (ctx: import("./keys.js").ShopContext, options?: Omit<import("@tanstack/react-query").UseMutationOptions<void, Error, number>, "mutationFn">) => import("@tanstack/react-query").UseMutationResult<void, Error, number, unknown>;
+    useImportJson: (ctx: import("./keys.js").ShopContext, options?: Omit<import("@tanstack/react-query").UseMutationOptions<import("@sales-planner/shared").ImportResult, Error, import("@sales-planner/shared").CodedTitledItem[], unknown>, "mutationFn"> | undefined) => import("@tanstack/react-query").UseMutationResult<import("@sales-planner/shared").ImportResult, Error, import("@sales-planner/shared").CodedTitledItem[], unknown>;
+    useImportCsv: (ctx: import("./keys.js").ShopContext, options?: Omit<import("@tanstack/react-query").UseMutationOptions<import("@sales-planner/shared").ImportResult, Error, string>, "mutationFn">) => import("@tanstack/react-query").UseMutationResult<import("@sales-planner/shared").ImportResult, Error, string, unknown>;
+};
+export declare const categories: {
+    useList: (ctx: import("./keys.js").ShopContext, query?: import("@sales-planner/shared").PaginationQuery, options?: Omit<import("@tanstack/react-query").UseQueryOptions<import("@sales-planner/shared").PaginatedResponse<Category>, Error, import("@sales-planner/shared").PaginatedResponse<Category>, readonly unknown[]>, "queryKey" | "queryFn"> | undefined) => import("@tanstack/react-query").UseQueryResult<import("@sales-planner/shared").PaginatedResponse<Category>, Error>;
+    useById: (ctx: import("./keys.js").ShopContext, id: number, options?: Omit<import("@tanstack/react-query").UseQueryOptions<Category, Error, Category, readonly unknown[]>, "queryKey" | "queryFn"> | undefined) => import("@tanstack/react-query").UseQueryResult<Category, Error>;
+    useByCode: (ctx: import("./keys.js").ShopContext, code: string, options?: Omit<import("@tanstack/react-query").UseQueryOptions<Category, Error, Category, readonly unknown[]>, "queryKey" | "queryFn"> | undefined) => import("@tanstack/react-query").UseQueryResult<Category, Error>;
+    useExportJson: (ctx: import("./keys.js").ShopContext, options?: Omit<import("@tanstack/react-query").UseQueryOptions<import("@sales-planner/shared").CodedTitledItem[], Error, import("@sales-planner/shared").CodedTitledItem[], readonly unknown[]>, "queryKey" | "queryFn"> | undefined) => import("@tanstack/react-query").UseQueryResult<import("@sales-planner/shared").CodedTitledItem[], Error>;
+    useExportCsv: (ctx: import("./keys.js").ShopContext, options?: Omit<import("@tanstack/react-query").UseQueryOptions<string>, "queryKey" | "queryFn">) => import("@tanstack/react-query").UseQueryResult<string, Error>;
+    useCreate: (ctx: import("./keys.js").ShopContext, options?: Omit<import("@tanstack/react-query").UseMutationOptions<Category, Error, import("@sales-planner/shared").CodedTitledItem, unknown>, "mutationFn"> | undefined) => import("@tanstack/react-query").UseMutationResult<Category, Error, import("@sales-planner/shared").CodedTitledItem, unknown>;
+    useUpdate: (ctx: import("./keys.js").ShopContext, options?: Omit<import("@tanstack/react-query").UseMutationOptions<Category, Error, {
+        id: number;
+        data: import("@sales-planner/shared").CodedTitledUpdateDto;
+    }, unknown>, "mutationFn"> | undefined) => import("@tanstack/react-query").UseMutationResult<Category, Error, {
+        id: number;
+        data: import("@sales-planner/shared").CodedTitledUpdateDto;
+    }, unknown>;
+    useDelete: (ctx: import("./keys.js").ShopContext, options?: Omit<import("@tanstack/react-query").UseMutationOptions<void, Error, number>, "mutationFn">) => import("@tanstack/react-query").UseMutationResult<void, Error, number, unknown>;
+    useImportJson: (ctx: import("./keys.js").ShopContext, options?: Omit<import("@tanstack/react-query").UseMutationOptions<import("@sales-planner/shared").ImportResult, Error, import("@sales-planner/shared").CodedTitledItem[], unknown>, "mutationFn"> | undefined) => import("@tanstack/react-query").UseMutationResult<import("@sales-planner/shared").ImportResult, Error, import("@sales-planner/shared").CodedTitledItem[], unknown>;
+    useImportCsv: (ctx: import("./keys.js").ShopContext, options?: Omit<import("@tanstack/react-query").UseMutationOptions<import("@sales-planner/shared").ImportResult, Error, string>, "mutationFn">) => import("@tanstack/react-query").UseMutationResult<import("@sales-planner/shared").ImportResult, Error, string, unknown>;
+};
+export declare const groups: {
+    useList: (ctx: import("./keys.js").ShopContext, query?: import("@sales-planner/shared").PaginationQuery, options?: Omit<import("@tanstack/react-query").UseQueryOptions<import("@sales-planner/shared").PaginatedResponse<Group>, Error, import("@sales-planner/shared").PaginatedResponse<Group>, readonly unknown[]>, "queryKey" | "queryFn"> | undefined) => import("@tanstack/react-query").UseQueryResult<import("@sales-planner/shared").PaginatedResponse<Group>, Error>;
+    useById: (ctx: import("./keys.js").ShopContext, id: number, options?: Omit<import("@tanstack/react-query").UseQueryOptions<Group, Error, Group, readonly unknown[]>, "queryKey" | "queryFn"> | undefined) => import("@tanstack/react-query").UseQueryResult<Group, Error>;
+    useByCode: (ctx: import("./keys.js").ShopContext, code: string, options?: Omit<import("@tanstack/react-query").UseQueryOptions<Group, Error, Group, readonly unknown[]>, "queryKey" | "queryFn"> | undefined) => import("@tanstack/react-query").UseQueryResult<Group, Error>;
+    useExportJson: (ctx: import("./keys.js").ShopContext, options?: Omit<import("@tanstack/react-query").UseQueryOptions<import("@sales-planner/shared").CodedTitledItem[], Error, import("@sales-planner/shared").CodedTitledItem[], readonly unknown[]>, "queryKey" | "queryFn"> | undefined) => import("@tanstack/react-query").UseQueryResult<import("@sales-planner/shared").CodedTitledItem[], Error>;
+    useExportCsv: (ctx: import("./keys.js").ShopContext, options?: Omit<import("@tanstack/react-query").UseQueryOptions<string>, "queryKey" | "queryFn">) => import("@tanstack/react-query").UseQueryResult<string, Error>;
+    useCreate: (ctx: import("./keys.js").ShopContext, options?: Omit<import("@tanstack/react-query").UseMutationOptions<Group, Error, import("@sales-planner/shared").CodedTitledItem, unknown>, "mutationFn"> | undefined) => import("@tanstack/react-query").UseMutationResult<Group, Error, import("@sales-planner/shared").CodedTitledItem, unknown>;
+    useUpdate: (ctx: import("./keys.js").ShopContext, options?: Omit<import("@tanstack/react-query").UseMutationOptions<Group, Error, {
+        id: number;
+        data: import("@sales-planner/shared").CodedTitledUpdateDto;
+    }, unknown>, "mutationFn"> | undefined) => import("@tanstack/react-query").UseMutationResult<Group, Error, {
+        id: number;
+        data: import("@sales-planner/shared").CodedTitledUpdateDto;
+    }, unknown>;
+    useDelete: (ctx: import("./keys.js").ShopContext, options?: Omit<import("@tanstack/react-query").UseMutationOptions<void, Error, number>, "mutationFn">) => import("@tanstack/react-query").UseMutationResult<void, Error, number, unknown>;
+    useImportJson: (ctx: import("./keys.js").ShopContext, options?: Omit<import("@tanstack/react-query").UseMutationOptions<import("@sales-planner/shared").ImportResult, Error, import("@sales-planner/shared").CodedTitledItem[], unknown>, "mutationFn"> | undefined) => import("@tanstack/react-query").UseMutationResult<import("@sales-planner/shared").ImportResult, Error, import("@sales-planner/shared").CodedTitledItem[], unknown>;
+    useImportCsv: (ctx: import("./keys.js").ShopContext, options?: Omit<import("@tanstack/react-query").UseMutationOptions<import("@sales-planner/shared").ImportResult, Error, string>, "mutationFn">) => import("@tanstack/react-query").UseMutationResult<import("@sales-planner/shared").ImportResult, Error, string, unknown>;
+};
+export declare const statuses: {
+    useList: (ctx: import("./keys.js").ShopContext, query?: import("@sales-planner/shared").PaginationQuery, options?: Omit<import("@tanstack/react-query").UseQueryOptions<import("@sales-planner/shared").PaginatedResponse<Status>, Error, import("@sales-planner/shared").PaginatedResponse<Status>, readonly unknown[]>, "queryKey" | "queryFn"> | undefined) => import("@tanstack/react-query").UseQueryResult<import("@sales-planner/shared").PaginatedResponse<Status>, Error>;
+    useById: (ctx: import("./keys.js").ShopContext, id: number, options?: Omit<import("@tanstack/react-query").UseQueryOptions<Status, Error, Status, readonly unknown[]>, "queryKey" | "queryFn"> | undefined) => import("@tanstack/react-query").UseQueryResult<Status, Error>;
+    useByCode: (ctx: import("./keys.js").ShopContext, code: string, options?: Omit<import("@tanstack/react-query").UseQueryOptions<Status, Error, Status, readonly unknown[]>, "queryKey" | "queryFn"> | undefined) => import("@tanstack/react-query").UseQueryResult<Status, Error>;
+    useExportJson: (ctx: import("./keys.js").ShopContext, options?: Omit<import("@tanstack/react-query").UseQueryOptions<import("@sales-planner/shared").CodedTitledItem[], Error, import("@sales-planner/shared").CodedTitledItem[], readonly unknown[]>, "queryKey" | "queryFn"> | undefined) => import("@tanstack/react-query").UseQueryResult<import("@sales-planner/shared").CodedTitledItem[], Error>;
+    useExportCsv: (ctx: import("./keys.js").ShopContext, options?: Omit<import("@tanstack/react-query").UseQueryOptions<string>, "queryKey" | "queryFn">) => import("@tanstack/react-query").UseQueryResult<string, Error>;
+    useCreate: (ctx: import("./keys.js").ShopContext, options?: Omit<import("@tanstack/react-query").UseMutationOptions<Status, Error, import("@sales-planner/shared").CodedTitledItem, unknown>, "mutationFn"> | undefined) => import("@tanstack/react-query").UseMutationResult<Status, Error, import("@sales-planner/shared").CodedTitledItem, unknown>;
+    useUpdate: (ctx: import("./keys.js").ShopContext, options?: Omit<import("@tanstack/react-query").UseMutationOptions<Status, Error, {
+        id: number;
+        data: import("@sales-planner/shared").CodedTitledUpdateDto;
+    }, unknown>, "mutationFn"> | undefined) => import("@tanstack/react-query").UseMutationResult<Status, Error, {
+        id: number;
+        data: import("@sales-planner/shared").CodedTitledUpdateDto;
+    }, unknown>;
+    useDelete: (ctx: import("./keys.js").ShopContext, options?: Omit<import("@tanstack/react-query").UseMutationOptions<void, Error, number>, "mutationFn">) => import("@tanstack/react-query").UseMutationResult<void, Error, number, unknown>;
+    useImportJson: (ctx: import("./keys.js").ShopContext, options?: Omit<import("@tanstack/react-query").UseMutationOptions<import("@sales-planner/shared").ImportResult, Error, import("@sales-planner/shared").CodedTitledItem[], unknown>, "mutationFn"> | undefined) => import("@tanstack/react-query").UseMutationResult<import("@sales-planner/shared").ImportResult, Error, import("@sales-planner/shared").CodedTitledItem[], unknown>;
+    useImportCsv: (ctx: import("./keys.js").ShopContext, options?: Omit<import("@tanstack/react-query").UseMutationOptions<import("@sales-planner/shared").ImportResult, Error, string>, "mutationFn">) => import("@tanstack/react-query").UseMutationResult<import("@sales-planner/shared").ImportResult, Error, string, unknown>;
+};
+export declare const suppliers: {
+    useList: (ctx: import("./keys.js").ShopContext, query?: import("@sales-planner/shared").PaginationQuery, options?: Omit<import("@tanstack/react-query").UseQueryOptions<import("@sales-planner/shared").PaginatedResponse<Supplier>, Error, import("@sales-planner/shared").PaginatedResponse<Supplier>, readonly unknown[]>, "queryKey" | "queryFn"> | undefined) => import("@tanstack/react-query").UseQueryResult<import("@sales-planner/shared").PaginatedResponse<Supplier>, Error>;
+    useById: (ctx: import("./keys.js").ShopContext, id: number, options?: Omit<import("@tanstack/react-query").UseQueryOptions<Supplier, Error, Supplier, readonly unknown[]>, "queryKey" | "queryFn"> | undefined) => import("@tanstack/react-query").UseQueryResult<Supplier, Error>;
+    useByCode: (ctx: import("./keys.js").ShopContext, code: string, options?: Omit<import("@tanstack/react-query").UseQueryOptions<Supplier, Error, Supplier, readonly unknown[]>, "queryKey" | "queryFn"> | undefined) => import("@tanstack/react-query").UseQueryResult<Supplier, Error>;
+    useExportJson: (ctx: import("./keys.js").ShopContext, options?: Omit<import("@tanstack/react-query").UseQueryOptions<import("@sales-planner/shared").CodedTitledItem[], Error, import("@sales-planner/shared").CodedTitledItem[], readonly unknown[]>, "queryKey" | "queryFn"> | undefined) => import("@tanstack/react-query").UseQueryResult<import("@sales-planner/shared").CodedTitledItem[], Error>;
+    useExportCsv: (ctx: import("./keys.js").ShopContext, options?: Omit<import("@tanstack/react-query").UseQueryOptions<string>, "queryKey" | "queryFn">) => import("@tanstack/react-query").UseQueryResult<string, Error>;
+    useCreate: (ctx: import("./keys.js").ShopContext, options?: Omit<import("@tanstack/react-query").UseMutationOptions<Supplier, Error, import("@sales-planner/shared").CodedTitledItem, unknown>, "mutationFn"> | undefined) => import("@tanstack/react-query").UseMutationResult<Supplier, Error, import("@sales-planner/shared").CodedTitledItem, unknown>;
+    useUpdate: (ctx: import("./keys.js").ShopContext, options?: Omit<import("@tanstack/react-query").UseMutationOptions<Supplier, Error, {
+        id: number;
+        data: import("@sales-planner/shared").CodedTitledUpdateDto;
+    }, unknown>, "mutationFn"> | undefined) => import("@tanstack/react-query").UseMutationResult<Supplier, Error, {
+        id: number;
+        data: import("@sales-planner/shared").CodedTitledUpdateDto;
+    }, unknown>;
+    useDelete: (ctx: import("./keys.js").ShopContext, options?: Omit<import("@tanstack/react-query").UseMutationOptions<void, Error, number>, "mutationFn">) => import("@tanstack/react-query").UseMutationResult<void, Error, number, unknown>;
+    useImportJson: (ctx: import("./keys.js").ShopContext, options?: Omit<import("@tanstack/react-query").UseMutationOptions<import("@sales-planner/shared").ImportResult, Error, import("@sales-planner/shared").CodedTitledItem[], unknown>, "mutationFn"> | undefined) => import("@tanstack/react-query").UseMutationResult<import("@sales-planner/shared").ImportResult, Error, import("@sales-planner/shared").CodedTitledItem[], unknown>;
+    useImportCsv: (ctx: import("./keys.js").ShopContext, options?: Omit<import("@tanstack/react-query").UseMutationOptions<import("@sales-planner/shared").ImportResult, Error, string>, "mutationFn">) => import("@tanstack/react-query").UseMutationResult<import("@sales-planner/shared").ImportResult, Error, string, unknown>;
+};
+export declare const warehouses: {
+    useList: (ctx: import("./keys.js").ShopContext, query?: import("@sales-planner/shared").PaginationQuery, options?: Omit<import("@tanstack/react-query").UseQueryOptions<import("@sales-planner/shared").PaginatedResponse<Warehouse>, Error, import("@sales-planner/shared").PaginatedResponse<Warehouse>, readonly unknown[]>, "queryKey" | "queryFn"> | undefined) => import("@tanstack/react-query").UseQueryResult<import("@sales-planner/shared").PaginatedResponse<Warehouse>, Error>;
+    useById: (ctx: import("./keys.js").ShopContext, id: number, options?: Omit<import("@tanstack/react-query").UseQueryOptions<Warehouse, Error, Warehouse, readonly unknown[]>, "queryKey" | "queryFn"> | undefined) => import("@tanstack/react-query").UseQueryResult<Warehouse, Error>;
+    useByCode: (ctx: import("./keys.js").ShopContext, code: string, options?: Omit<import("@tanstack/react-query").UseQueryOptions<Warehouse, Error, Warehouse, readonly unknown[]>, "queryKey" | "queryFn"> | undefined) => import("@tanstack/react-query").UseQueryResult<Warehouse, Error>;
+    useExportJson: (ctx: import("./keys.js").ShopContext, options?: Omit<import("@tanstack/react-query").UseQueryOptions<import("@sales-planner/shared").CodedTitledItem[], Error, import("@sales-planner/shared").CodedTitledItem[], readonly unknown[]>, "queryKey" | "queryFn"> | undefined) => import("@tanstack/react-query").UseQueryResult<import("@sales-planner/shared").CodedTitledItem[], Error>;
+    useExportCsv: (ctx: import("./keys.js").ShopContext, options?: Omit<import("@tanstack/react-query").UseQueryOptions<string>, "queryKey" | "queryFn">) => import("@tanstack/react-query").UseQueryResult<string, Error>;
+    useCreate: (ctx: import("./keys.js").ShopContext, options?: Omit<import("@tanstack/react-query").UseMutationOptions<Warehouse, Error, import("@sales-planner/shared").CodedTitledItem, unknown>, "mutationFn"> | undefined) => import("@tanstack/react-query").UseMutationResult<Warehouse, Error, import("@sales-planner/shared").CodedTitledItem, unknown>;
+    useUpdate: (ctx: import("./keys.js").ShopContext, options?: Omit<import("@tanstack/react-query").UseMutationOptions<Warehouse, Error, {
+        id: number;
+        data: import("@sales-planner/shared").CodedTitledUpdateDto;
+    }, unknown>, "mutationFn"> | undefined) => import("@tanstack/react-query").UseMutationResult<Warehouse, Error, {
+        id: number;
+        data: import("@sales-planner/shared").CodedTitledUpdateDto;
+    }, unknown>;
+    useDelete: (ctx: import("./keys.js").ShopContext, options?: Omit<import("@tanstack/react-query").UseMutationOptions<void, Error, number>, "mutationFn">) => import("@tanstack/react-query").UseMutationResult<void, Error, number, unknown>;
+    useImportJson: (ctx: import("./keys.js").ShopContext, options?: Omit<import("@tanstack/react-query").UseMutationOptions<import("@sales-planner/shared").ImportResult, Error, import("@sales-planner/shared").CodedTitledItem[], unknown>, "mutationFn"> | undefined) => import("@tanstack/react-query").UseMutationResult<import("@sales-planner/shared").ImportResult, Error, import("@sales-planner/shared").CodedTitledItem[], unknown>;
+    useImportCsv: (ctx: import("./keys.js").ShopContext, options?: Omit<import("@tanstack/react-query").UseMutationOptions<import("@sales-planner/shared").ImportResult, Error, string>, "mutationFn">) => import("@tanstack/react-query").UseMutationResult<import("@sales-planner/shared").ImportResult, Error, string, unknown>;
+};
+export declare const marketplaces: {
+    useList: (ctx: import("./keys.js").ShopContext, query?: import("@sales-planner/shared").PaginationQuery, options?: Omit<import("@tanstack/react-query").UseQueryOptions<import("@sales-planner/shared").PaginatedResponse<Marketplace>, Error, import("@sales-planner/shared").PaginatedResponse<Marketplace>, readonly unknown[]>, "queryKey" | "queryFn"> | undefined) => import("@tanstack/react-query").UseQueryResult<import("@sales-planner/shared").PaginatedResponse<Marketplace>, Error>;
+    useById: (ctx: import("./keys.js").ShopContext, id: number, options?: Omit<import("@tanstack/react-query").UseQueryOptions<Marketplace, Error, Marketplace, readonly unknown[]>, "queryKey" | "queryFn"> | undefined) => import("@tanstack/react-query").UseQueryResult<Marketplace, Error>;
+    useByCode: (ctx: import("./keys.js").ShopContext, code: string, options?: Omit<import("@tanstack/react-query").UseQueryOptions<Marketplace, Error, Marketplace, readonly unknown[]>, "queryKey" | "queryFn"> | undefined) => import("@tanstack/react-query").UseQueryResult<Marketplace, Error>;
+    useExportJson: (ctx: import("./keys.js").ShopContext, options?: Omit<import("@tanstack/react-query").UseQueryOptions<import("@sales-planner/shared").CodedTitledItem[], Error, import("@sales-planner/shared").CodedTitledItem[], readonly unknown[]>, "queryKey" | "queryFn"> | undefined) => import("@tanstack/react-query").UseQueryResult<import("@sales-planner/shared").CodedTitledItem[], Error>;
+    useExportCsv: (ctx: import("./keys.js").ShopContext, options?: Omit<import("@tanstack/react-query").UseQueryOptions<string>, "queryKey" | "queryFn">) => import("@tanstack/react-query").UseQueryResult<string, Error>;
+    useCreate: (ctx: import("./keys.js").ShopContext, options?: Omit<import("@tanstack/react-query").UseMutationOptions<Marketplace, Error, import("@sales-planner/shared").CodedTitledItem, unknown>, "mutationFn"> | undefined) => import("@tanstack/react-query").UseMutationResult<Marketplace, Error, import("@sales-planner/shared").CodedTitledItem, unknown>;
+    useUpdate: (ctx: import("./keys.js").ShopContext, options?: Omit<import("@tanstack/react-query").UseMutationOptions<Marketplace, Error, {
+        id: number;
+        data: import("@sales-planner/shared").CodedTitledUpdateDto;
+    }, unknown>, "mutationFn"> | undefined) => import("@tanstack/react-query").UseMutationResult<Marketplace, Error, {
+        id: number;
+        data: import("@sales-planner/shared").CodedTitledUpdateDto;
+    }, unknown>;
+    useDelete: (ctx: import("./keys.js").ShopContext, options?: Omit<import("@tanstack/react-query").UseMutationOptions<void, Error, number>, "mutationFn">) => import("@tanstack/react-query").UseMutationResult<void, Error, number, unknown>;
+    useImportJson: (ctx: import("./keys.js").ShopContext, options?: Omit<import("@tanstack/react-query").UseMutationOptions<import("@sales-planner/shared").ImportResult, Error, import("@sales-planner/shared").CodedTitledItem[], unknown>, "mutationFn"> | undefined) => import("@tanstack/react-query").UseMutationResult<import("@sales-planner/shared").ImportResult, Error, import("@sales-planner/shared").CodedTitledItem[], unknown>;
+    useImportCsv: (ctx: import("./keys.js").ShopContext, options?: Omit<import("@tanstack/react-query").UseMutationOptions<import("@sales-planner/shared").ImportResult, Error, string>, "mutationFn">) => import("@tanstack/react-query").UseMutationResult<import("@sales-planner/shared").ImportResult, Error, string, unknown>;
+};
+//# sourceMappingURL=coded-entities.d.ts.map

package/dist/coded-entities.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"coded-entities.d.ts","sourceRoot":"","sources":["../src/coded-entities.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,KAAK,EAKL,QAAQ,EAKR,KAAK,EAKL,MAAM,EAKN,QAAQ,EAKR,SAAS,EAKT,WAAW,EAKZ,MAAM,uBAAuB,CAAC;AAG/B,eAAO,MAAM,MAAM;;;;;;;;;;;;;;;;;CAMS,CAAC;AAE7B,eAAO,MAAM,UAAU;;;;;;;;;;;;;;;;;CAMa,CAAC;AAErC,eAAO,MAAM,MAAM;;;;;;;;;;;;;;;;;CAMS,CAAC;AAE7B,eAAO,MAAM,QAAQ;;;;;;;;;;;;;;;;;CAMW,CAAC;AAEjC,eAAO,MAAM,SAAS;;;;;;;;;;;;;;;;;CAMY,CAAC;AAEnC,eAAO,MAAM,UAAU;;;;;;;;;;;;;;;;;CAMa,CAAC;AAErC,eAAO,MAAM,YAAY;;;;;;;;;;;;;;;;;CAMe,CAAC"}

package/dist/coded-entities.js

@@ -0,0 +1,8 @@
+import { createCodedEntityHooks } from './create-coded-entity-hooks.js';
+export const brands = createCodedEntityHooks('brands', (c) => c.brands);
+export const categories = createCodedEntityHooks('categories', (c) => c.categories);
+export const groups = createCodedEntityHooks('groups', (c) => c.groups);
+export const statuses = createCodedEntityHooks('statuses', (c) => c.statuses);
+export const suppliers = createCodedEntityHooks('suppliers', (c) => c.suppliers);
+export const warehouses = createCodedEntityHooks('warehouses', (c) => c.warehouses);
+export const marketplaces = createCodedEntityHooks('marketplaces', (c) => c.marketplaces);

package/dist/create-coded-entity-hooks.d.ts

@@ -0,0 +1,39 @@
+import type { UseQueryOptions, UseMutationOptions } from '@tanstack/react-query';
+import type { PaginatedResponse, PaginationQuery, ImportResult, ShopContextParams } from '@sales-planner/shared';
+import { useSalesPlannerClient } from './provider.js';
+import type { ShopContext } from './keys.js';
+type CodedEntityClientLike<TEntity, TCreate, TUpdate, TImport, TExport> = {
+    getAll(ctx: ShopContextParams, query?: PaginationQuery): Promise<PaginatedResponse<TEntity>>;
+    getById(ctx: ShopContextParams, id: number): Promise<TEntity>;
+    getByCode(ctx: ShopContextParams, code: string): Promise<TEntity>;
+    create(ctx: ShopContextParams, request: TCreate): Promise<TEntity>;
+    update(ctx: ShopContextParams, id: number, request: TUpdate): Promise<TEntity>;
+    delete(ctx: ShopContextParams, id: number): Promise<void>;
+    importJson(ctx: ShopContextParams, items: TImport[]): Promise<ImportResult>;
+    importCsv(ctx: ShopContextParams, csvContent: string): Promise<ImportResult>;
+    exportJson(ctx: ShopContextParams): Promise<TExport[]>;
+    exportCsv(ctx: ShopContextParams): Promise<string>;
+};
+/**
+ * Creates a set of React Query hooks for a coded entity (brands, categories, etc.)
+ */
+export declare function createCodedEntityHooks<TEntity, TCreate, TUpdate, TImport, TExport>(entityName: string, getClient: (client: ReturnType<typeof useSalesPlannerClient>) => CodedEntityClientLike<TEntity, TCreate, TUpdate, TImport, TExport>): {
+    useList: (ctx: ShopContext, query?: PaginationQuery, options?: Omit<UseQueryOptions<PaginatedResponse<TEntity>>, "queryKey" | "queryFn">) => import("@tanstack/react-query").UseQueryResult<PaginatedResponse<TEntity>, Error>;
+    useById: (ctx: ShopContext, id: number, options?: Omit<UseQueryOptions<TEntity>, "queryKey" | "queryFn">) => import("@tanstack/react-query").UseQueryResult<import("@tanstack/react-query").NoInfer<TEntity>, Error>;
+    useByCode: (ctx: ShopContext, code: string, options?: Omit<UseQueryOptions<TEntity>, "queryKey" | "queryFn">) => import("@tanstack/react-query").UseQueryResult<import("@tanstack/react-query").NoInfer<TEntity>, Error>;
+    useExportJson: (ctx: ShopContext, options?: Omit<UseQueryOptions<TExport[]>, "queryKey" | "queryFn">) => import("@tanstack/react-query").UseQueryResult<TExport[], Error>;
+    useExportCsv: (ctx: ShopContext, options?: Omit<UseQueryOptions<string>, "queryKey" | "queryFn">) => import("@tanstack/react-query").UseQueryResult<string, Error>;
+    useCreate: (ctx: ShopContext, options?: Omit<UseMutationOptions<TEntity, Error, TCreate>, "mutationFn">) => import("@tanstack/react-query").UseMutationResult<TEntity, Error, TCreate, unknown>;
+    useUpdate: (ctx: ShopContext, options?: Omit<UseMutationOptions<TEntity, Error, {
+        id: number;
+        data: TUpdate;
+    }>, "mutationFn">) => import("@tanstack/react-query").UseMutationResult<TEntity, Error, {
+        id: number;
+        data: TUpdate;
+    }, unknown>;
+    useDelete: (ctx: ShopContext, options?: Omit<UseMutationOptions<void, Error, number>, "mutationFn">) => import("@tanstack/react-query").UseMutationResult<void, Error, number, unknown>;
+    useImportJson: (ctx: ShopContext, options?: Omit<UseMutationOptions<ImportResult, Error, TImport[]>, "mutationFn">) => import("@tanstack/react-query").UseMutationResult<ImportResult, Error, TImport[], unknown>;
+    useImportCsv: (ctx: ShopContext, options?: Omit<UseMutationOptions<ImportResult, Error, string>, "mutationFn">) => import("@tanstack/react-query").UseMutationResult<ImportResult, Error, string, unknown>;
+};
+export {};
+//# sourceMappingURL=create-coded-entity-hooks.d.ts.map

package/dist/create-coded-entity-hooks.d.ts.map

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

package/dist/create-coded-entity-hooks.js

@@ -0,0 +1,117 @@
+import { useQuery, useMutation, useQueryClient } from '@tanstack/react-query';
+import { useSalesPlannerClient } from './provider.js';
+import { queryKeys, toShopContextParams } from './keys.js';
+/**
+ * Creates a set of React Query hooks for a coded entity (brands, categories, etc.)
+ */
+export function createCodedEntityHooks(entityName, getClient) {
+    function useList(ctx, query, options) {
+        const client = useSalesPlannerClient();
+        return useQuery({
+            queryKey: queryKeys.entityList(entityName, ctx, query),
+            queryFn: () => getClient(client).getAll(toShopContextParams(ctx), query),
+            ...options,
+        });
+    }
+    function useById(ctx, id, options) {
+        const client = useSalesPlannerClient();
+        return useQuery({
+            queryKey: queryKeys.entityDetail(entityName, ctx, id),
+            queryFn: () => getClient(client).getById(toShopContextParams(ctx), id),
+            ...options,
+        });
+    }
+    function useByCode(ctx, code, options) {
+        const client = useSalesPlannerClient();
+        return useQuery({
+            queryKey: queryKeys.entityByCode(entityName, ctx, code),
+            queryFn: () => getClient(client).getByCode(toShopContextParams(ctx), code),
+            ...options,
+        });
+    }
+    function useExportJson(ctx, options) {
+        const client = useSalesPlannerClient();
+        return useQuery({
+            queryKey: queryKeys.entityExport(entityName, ctx, 'json'),
+            queryFn: () => getClient(client).exportJson(toShopContextParams(ctx)),
+            enabled: false, // manual trigger only
+            ...options,
+        });
+    }
+    function useExportCsv(ctx, options) {
+        const client = useSalesPlannerClient();
+        return useQuery({
+            queryKey: queryKeys.entityExport(entityName, ctx, 'csv'),
+            queryFn: () => getClient(client).exportCsv(toShopContextParams(ctx)),
+            enabled: false,
+            ...options,
+        });
+    }
+    function useCreate(ctx, options) {
+        const client = useSalesPlannerClient();
+        const queryClient = useQueryClient();
+        return useMutation({
+            mutationFn: (request) => getClient(client).create(toShopContextParams(ctx), request),
+            onSuccess: () => {
+                queryClient.invalidateQueries({ queryKey: queryKeys.entity(entityName, ctx) });
+            },
+            ...options,
+        });
+    }
+    function useUpdate(ctx, options) {
+        const client = useSalesPlannerClient();
+        const queryClient = useQueryClient();
+        return useMutation({
+            mutationFn: ({ id, data }) => getClient(client).update(toShopContextParams(ctx), id, data),
+            onSuccess: () => {
+                queryClient.invalidateQueries({ queryKey: queryKeys.entity(entityName, ctx) });
+            },
+            ...options,
+        });
+    }
+    function useDelete(ctx, options) {
+        const client = useSalesPlannerClient();
+        const queryClient = useQueryClient();
+        return useMutation({
+            mutationFn: (id) => getClient(client).delete(toShopContextParams(ctx), id),
+            onSuccess: () => {
+                queryClient.invalidateQueries({ queryKey: queryKeys.entity(entityName, ctx) });
+            },
+            ...options,
+        });
+    }
+    function useImportJson(ctx, options) {
+        const client = useSalesPlannerClient();
+        const queryClient = useQueryClient();
+        return useMutation({
+            mutationFn: (items) => getClient(client).importJson(toShopContextParams(ctx), items),
+            onSuccess: () => {
+                queryClient.invalidateQueries({ queryKey: queryKeys.entity(entityName, ctx) });
+            },
+            ...options,
+        });
+    }
+    function useImportCsv(ctx, options) {
+        const client = useSalesPlannerClient();
+        const queryClient = useQueryClient();
+        return useMutation({
+            mutationFn: (csvContent) => getClient(client).importCsv(toShopContextParams(ctx), csvContent),
+            onSuccess: () => {
+                queryClient.invalidateQueries({ queryKey: queryKeys.entity(entityName, ctx) });
+            },
+            ...options,
+        });
+    }
+    return {
+        useList,
+        useById,
+        useByCode,
+        useExportJson,
+        useExportCsv,
+        useCreate,
+        useUpdate,
+        useDelete,
+        useImportJson,
+        useImportCsv,
+    };
+}

package/dist/create-shop-scoped-hooks.d.ts

@@ -0,0 +1,38 @@
+import type { UseQueryOptions, UseMutationOptions } from '@tanstack/react-query';
+import type { PaginatedResponse, ShopContextParams } from '@sales-planner/shared';
+import { useSalesPlannerClient } from './provider.js';
+import type { ShopContext } from './keys.js';
+type ShopScopedClientLike<TEntity, TCreate, TUpdate, TImport, TExport, TImportResult, TQuery> = {
+    getAll(ctx: ShopContextParams, query?: TQuery): Promise<PaginatedResponse<TEntity>>;
+    getById(ctx: ShopContextParams, id: number): Promise<TEntity>;
+    create(ctx: ShopContextParams, request: TCreate): Promise<TEntity>;
+    update(ctx: ShopContextParams, id: number, request: TUpdate): Promise<TEntity>;
+    delete(ctx: ShopContextParams, id: number): Promise<void>;
+    importJson(ctx: ShopContextParams, items: TImport[]): Promise<TImportResult>;
+    importCsv(ctx: ShopContextParams, csvContent: string): Promise<TImportResult>;
+    exportJson(ctx: ShopContextParams, query?: TQuery): Promise<TExport[]>;
+    exportCsv(ctx: ShopContextParams, query?: TQuery): Promise<string>;
+};
+/**
+ * Creates a set of React Query hooks for a shop-scoped entity
+ * (sales history, leftovers, seasonal coefficients, competitor entities)
+ */
+export declare function createShopScopedHooks<TEntity, TCreate, TUpdate, TImport, TExport, TImportResult, TQuery = Record<string, never>>(entityName: string, getClient: (client: ReturnType<typeof useSalesPlannerClient>) => ShopScopedClientLike<TEntity, TCreate, TUpdate, TImport, TExport, TImportResult, TQuery>): {
+    useList: (ctx: ShopContext, query?: TQuery, options?: Omit<UseQueryOptions<PaginatedResponse<TEntity>>, "queryKey" | "queryFn">) => import("@tanstack/react-query").UseQueryResult<PaginatedResponse<TEntity>, Error>;
+    useById: (ctx: ShopContext, id: number, options?: Omit<UseQueryOptions<TEntity>, "queryKey" | "queryFn">) => import("@tanstack/react-query").UseQueryResult<import("@tanstack/react-query").NoInfer<TEntity>, Error>;
+    useExportJson: (ctx: ShopContext, query?: TQuery, options?: Omit<UseQueryOptions<TExport[]>, "queryKey" | "queryFn">) => import("@tanstack/react-query").UseQueryResult<TExport[], Error>;
+    useExportCsv: (ctx: ShopContext, query?: TQuery, options?: Omit<UseQueryOptions<string>, "queryKey" | "queryFn">) => import("@tanstack/react-query").UseQueryResult<string, Error>;
+    useCreate: (ctx: ShopContext, options?: Omit<UseMutationOptions<TEntity, Error, TCreate>, "mutationFn">) => import("@tanstack/react-query").UseMutationResult<TEntity, Error, TCreate, unknown>;
+    useUpdate: (ctx: ShopContext, options?: Omit<UseMutationOptions<TEntity, Error, {
+        id: number;
+        data: TUpdate;
+    }>, "mutationFn">) => import("@tanstack/react-query").UseMutationResult<TEntity, Error, {
+        id: number;
+        data: TUpdate;
+    }, unknown>;
+    useDelete: (ctx: ShopContext, options?: Omit<UseMutationOptions<void, Error, number>, "mutationFn">) => import("@tanstack/react-query").UseMutationResult<void, Error, number, unknown>;
+    useImportJson: (ctx: ShopContext, options?: Omit<UseMutationOptions<TImportResult, Error, TImport[]>, "mutationFn">) => import("@tanstack/react-query").UseMutationResult<TImportResult, Error, TImport[], unknown>;
+    useImportCsv: (ctx: ShopContext, options?: Omit<UseMutationOptions<TImportResult, Error, string>, "mutationFn">) => import("@tanstack/react-query").UseMutationResult<TImportResult, Error, string, unknown>;
+};
+export {};
+//# sourceMappingURL=create-shop-scoped-hooks.d.ts.map

package/dist/create-shop-scoped-hooks.d.ts.map

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

package/dist/create-shop-scoped-hooks.js

@@ -0,0 +1,109 @@
+import { useQuery, useMutation, useQueryClient } from '@tanstack/react-query';
+import { useSalesPlannerClient } from './provider.js';
+import { queryKeys, toShopContextParams } from './keys.js';
+/**
+ * Creates a set of React Query hooks for a shop-scoped entity
+ * (sales history, leftovers, seasonal coefficients, competitor entities)
+ */
+export function createShopScopedHooks(entityName, getClient) {
+    function useList(ctx, query, options) {
+        const client = useSalesPlannerClient();
+        return useQuery({
+            queryKey: queryKeys.entityList(entityName, ctx, query),
+            queryFn: () => getClient(client).getAll(toShopContextParams(ctx), query),
+            ...options,
+        });
+    }
+    function useById(ctx, id, options) {
+        const client = useSalesPlannerClient();
+        return useQuery({
+            queryKey: queryKeys.entityDetail(entityName, ctx, id),
+            queryFn: () => getClient(client).getById(toShopContextParams(ctx), id),
+            ...options,
+        });
+    }
+    function useExportJson(ctx, query, options) {
+        const client = useSalesPlannerClient();
+        return useQuery({
+            queryKey: queryKeys.entityExport(entityName, ctx, 'json'),
+            queryFn: () => getClient(client).exportJson(toShopContextParams(ctx), query),
+            enabled: false,
+            ...options,
+        });
+    }
+    function useExportCsv(ctx, query, options) {
+        const client = useSalesPlannerClient();
+        return useQuery({
+            queryKey: queryKeys.entityExport(entityName, ctx, 'csv'),
+            queryFn: () => getClient(client).exportCsv(toShopContextParams(ctx), query),
+            enabled: false,
+            ...options,
+        });
+    }
+    function useCreate(ctx, options) {
+        const client = useSalesPlannerClient();
+        const queryClient = useQueryClient();
+        return useMutation({
+            mutationFn: (request) => getClient(client).create(toShopContextParams(ctx), request),
+            onSuccess: () => {
+                queryClient.invalidateQueries({ queryKey: queryKeys.entity(entityName, ctx) });
+            },
+            ...options,
+        });
+    }
+    function useUpdate(ctx, options) {
+        const client = useSalesPlannerClient();
+        const queryClient = useQueryClient();
+        return useMutation({
+            mutationFn: ({ id, data }) => getClient(client).update(toShopContextParams(ctx), id, data),
+            onSuccess: () => {
+                queryClient.invalidateQueries({ queryKey: queryKeys.entity(entityName, ctx) });
+            },
+            ...options,
+        });
+    }
+    function useDelete(ctx, options) {
+        const client = useSalesPlannerClient();
+        const queryClient = useQueryClient();
+        return useMutation({
+            mutationFn: (id) => getClient(client).delete(toShopContextParams(ctx), id),
+            onSuccess: () => {
+                queryClient.invalidateQueries({ queryKey: queryKeys.entity(entityName, ctx) });
+            },
+            ...options,
+        });
+    }
+    function useImportJson(ctx, options) {
+        const client = useSalesPlannerClient();
+        const queryClient = useQueryClient();
+        return useMutation({
+            mutationFn: (items) => getClient(client).importJson(toShopContextParams(ctx), items),
+            onSuccess: () => {
+                queryClient.invalidateQueries({ queryKey: queryKeys.entity(entityName, ctx) });
+            },
+            ...options,
+        });
+    }
+    function useImportCsv(ctx, options) {
+        const client = useSalesPlannerClient();
+        const queryClient = useQueryClient();
+        return useMutation({
+            mutationFn: (csvContent) => getClient(client).importCsv(toShopContextParams(ctx), csvContent),
+            onSuccess: () => {
+                queryClient.invalidateQueries({ queryKey: queryKeys.entity(entityName, ctx) });
+            },
+            ...options,
+        });
+    }
+    return {
+        useList,
+        useById,
+        useExportJson,
+        useExportCsv,
+        useCreate,
+        useUpdate,
+        useDelete,
+        useImportJson,
+        useImportCsv,
+    };
+}

package/dist/index.d.ts

@@ -0,0 +1,22 @@
+export { SalesPlannerProvider, useSalesPlannerClient } from './provider.js';
+export type { SalesPlannerProviderProps, ClientConfig } from './provider.js';
+export { queryKeys, toShopContextParams } from './keys.js';
+export type { ShopContext } from './keys.js';
+export { createCodedEntityHooks } from './create-coded-entity-hooks.js';
+export { createShopScopedHooks } from './create-shop-scoped-hooks.js';
+export { brands } from './coded-entities.js';
+export { categories } from './coded-entities.js';
+export { groups } from './coded-entities.js';
+export { statuses } from './coded-entities.js';
+export { suppliers } from './coded-entities.js';
+export { warehouses } from './coded-entities.js';
+export { marketplaces } from './coded-entities.js';
+export { skus } from './shop-scoped-entities.js';
+export { salesHistory } from './shop-scoped-entities.js';
+export { leftovers } from './shop-scoped-entities.js';
+export { seasonalCoefficients } from './shop-scoped-entities.js';
+export { skuCompetitorMappings } from './shop-scoped-entities.js';
+export { competitorProducts } from './shop-scoped-entities.js';
+export { competitorSales } from './shop-scoped-entities.js';
+export { useMe, useEntitiesMetadata, useSkuMetrics, useSkuMetricsById, useSkuMetricsByAbcClass, useSkuMetricsExportCsv, useComputedViews, useRefreshAllViews, } from './specialized.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,oBAAoB,EAAE,qBAAqB,EAAE,MAAM,eAAe,CAAC;AAC5E,YAAY,EAAE,yBAAyB,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AAG7E,OAAO,EAAE,SAAS,EAAE,mBAAmB,EAAE,MAAM,WAAW,CAAC;AAC3D,YAAY,EAAE,WAAW,EAAE,MAAM,WAAW,CAAC;AAG7C,OAAO,EAAE,sBAAsB,EAAE,MAAM,gCAAgC,CAAC;AACxE,OAAO,EAAE,qBAAqB,EAAE,MAAM,+BAA+B,CAAC;AAGtE,OAAO,EAAE,MAAM,EAAE,MAAM,qBAAqB,CAAC;AAC7C,OAAO,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAC;AACjD,OAAO,EAAE,MAAM,EAAE,MAAM,qBAAqB,CAAC;AAC7C,OAAO,EAAE,QAAQ,EAAE,MAAM,qBAAqB,CAAC;AAC/C,OAAO,EAAE,SAAS,EAAE,MAAM,qBAAqB,CAAC;AAChD,OAAO,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAC;AACjD,OAAO,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAGnD,OAAO,EAAE,IAAI,EAAE,MAAM,2BAA2B,CAAC;AACjD,OAAO,EAAE,YAAY,EAAE,MAAM,2BAA2B,CAAC;AACzD,OAAO,EAAE,SAAS,EAAE,MAAM,2BAA2B,CAAC;AACtD,OAAO,EAAE,oBAAoB,EAAE,MAAM,2BAA2B,CAAC;AACjE,OAAO,EAAE,qBAAqB,EAAE,MAAM,2BAA2B,CAAC;AAClE,OAAO,EAAE,kBAAkB,EAAE,MAAM,2BAA2B,CAAC;AAC/D,OAAO,EAAE,eAAe,EAAE,MAAM,2BAA2B,CAAC;AAG5D,OAAO,EACL,KAAK,EACL,mBAAmB,EACnB,aAAa,EACb,iBAAiB,EACjB,uBAAuB,EACvB,sBAAsB,EACtB,gBAAgB,EAChB,kBAAkB,GACnB,MAAM,kBAAkB,CAAC"}

package/dist/index.js

@@ -0,0 +1,25 @@
+// Provider
+export { SalesPlannerProvider, useSalesPlannerClient } from './provider.js';
+// Query keys for custom cache management
+export { queryKeys, toShopContextParams } from './keys.js';
+// Hook factories (for advanced use)
+export { createCodedEntityHooks } from './create-coded-entity-hooks.js';
+export { createShopScopedHooks } from './create-shop-scoped-hooks.js';
+// ── Coded entity hooks ──
+export { brands } from './coded-entities.js';
+export { categories } from './coded-entities.js';
+export { groups } from './coded-entities.js';
+export { statuses } from './coded-entities.js';
+export { suppliers } from './coded-entities.js';
+export { warehouses } from './coded-entities.js';
+export { marketplaces } from './coded-entities.js';
+// ── Shop-scoped entity hooks ──
+export { skus } from './shop-scoped-entities.js';
+export { salesHistory } from './shop-scoped-entities.js';
+export { leftovers } from './shop-scoped-entities.js';
+export { seasonalCoefficients } from './shop-scoped-entities.js';
+export { skuCompetitorMappings } from './shop-scoped-entities.js';
+export { competitorProducts } from './shop-scoped-entities.js';
+export { competitorSales } from './shop-scoped-entities.js';
+// ── Specialized hooks ──
+export { useMe, useEntitiesMetadata, useSkuMetrics, useSkuMetricsById, useSkuMetricsByAbcClass, useSkuMetricsExportCsv, useComputedViews, useRefreshAllViews, } from './specialized.js';

package/dist/keys.d.ts

@@ -0,0 +1,27 @@
+import type { ShopContextParams } from '@sales-planner/shared';
+/**
+ * Common shop context required by most hooks
+ */
+export interface ShopContext {
+    shopId: number;
+    tenantId: number;
+}
+export declare function toShopContextParams(ctx: ShopContext): ShopContextParams;
+/**
+ * Standard query key factory for cache management
+ */
+export declare const queryKeys: {
+    readonly me: () => readonly ["sales-planner", "me"];
+    readonly metadata: () => readonly ["sales-planner", "metadata"];
+    readonly entity: (entity: string, ctx: ShopContext) => readonly ["sales-planner", string, number, number];
+    readonly entityList: (entity: string, ctx: ShopContext, query?: Record<string, unknown>) => readonly ["sales-planner", string, number, number, "list", Record<string, unknown>];
+    readonly entityDetail: (entity: string, ctx: ShopContext, id: number) => readonly ["sales-planner", string, number, number, number];
+    readonly entityByCode: (entity: string, ctx: ShopContext, code: string) => readonly ["sales-planner", string, number, number, "code", string];
+    readonly entityExport: (entity: string, ctx: ShopContext, format: "json" | "csv") => readonly ["sales-planner", string, number, number, "export", "json" | "csv"];
+    readonly skuMetrics: (ctx: ShopContext) => readonly ["sales-planner", "sku-metrics", number, number];
+    readonly skuMetricsList: (ctx: ShopContext, query?: Record<string, unknown>) => readonly ["sales-planner", "sku-metrics", number, number, "list", Record<string, unknown>];
+    readonly skuMetricsDetail: (ctx: ShopContext, id: number) => readonly ["sales-planner", "sku-metrics", number, number, number];
+    readonly skuMetricsAbc: (ctx: ShopContext, abcClass: string) => readonly ["sales-planner", "sku-metrics", number, number, "abc", string];
+    readonly computed: (ctx: ShopContext) => readonly ["sales-planner", "computed", number, number];
+};
+//# sourceMappingURL=keys.d.ts.map

package/dist/keys.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"keys.d.ts","sourceRoot":"","sources":["../src/keys.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,uBAAuB,CAAC;AAE/D;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,wBAAgB,mBAAmB,CAAC,GAAG,EAAE,WAAW,GAAG,iBAAiB,CAEvE;AAED;;GAEG;AACH,eAAO,MAAM,SAAS;;;8BAIH,MAAM,OAAO,WAAW;kCAGpB,MAAM,OAAO,WAAW,UAAU,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;oCAGvD,MAAM,OAAO,WAAW,MAAM,MAAM;oCAGpC,MAAM,OAAO,WAAW,QAAQ,MAAM;oCAGtC,MAAM,OAAO,WAAW,UAAU,MAAM,GAAG,KAAK;+BAGrD,WAAW;mCAEP,WAAW,UAAU,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;qCAE1C,WAAW,MAAM,MAAM;kCAC1B,WAAW,YAAY,MAAM;6BAGlC,WAAW;CACnB,CAAC"}

package/dist/keys.js

@@ -0,0 +1,20 @@
+export function toShopContextParams(ctx) {
+    return { shop_id: ctx.shopId, tenant_id: ctx.tenantId };
+}
+/**
+ * Standard query key factory for cache management
+ */
+export const queryKeys = {
+    me: () => ['sales-planner', 'me'],
+    metadata: () => ['sales-planner', 'metadata'],
+    entity: (entity, ctx) => ['sales-planner', entity, ctx.shopId, ctx.tenantId],
+    entityList: (entity, ctx, query) => [...queryKeys.entity(entity, ctx), 'list', query ?? {}],
+    entityDetail: (entity, ctx, id) => [...queryKeys.entity(entity, ctx), id],
+    entityByCode: (entity, ctx, code) => [...queryKeys.entity(entity, ctx), 'code', code],
+    entityExport: (entity, ctx, format) => [...queryKeys.entity(entity, ctx), 'export', format],
+    skuMetrics: (ctx) => ['sales-planner', 'sku-metrics', ctx.shopId, ctx.tenantId],
+    skuMetricsList: (ctx, query) => [...queryKeys.skuMetrics(ctx), 'list', query ?? {}],
+    skuMetricsDetail: (ctx, id) => [...queryKeys.skuMetrics(ctx), id],
+    skuMetricsAbc: (ctx, abcClass) => [...queryKeys.skuMetrics(ctx), 'abc', abcClass],
+    computed: (ctx) => ['sales-planner', 'computed', ctx.shopId, ctx.tenantId],
+};

package/dist/provider.d.ts

@@ -0,0 +1,36 @@
+import { SalesPlannerClient } from '@sales-planner/http-client';
+import type { ClientConfig } from '@sales-planner/http-client';
+export type { ClientConfig } from '@sales-planner/http-client';
+export interface SalesPlannerProviderProps {
+    config: ClientConfig;
+    children: React.ReactNode;
+}
+/**
+ * Provides a SalesPlannerClient instance to all child components.
+ * Must be used inside a TanStack QueryClientProvider.
+ *
+ * @example
+ * ```tsx
+ * import { QueryClient, QueryClientProvider } from '@tanstack/react-query';
+ * import { SalesPlannerProvider } from '@sales-planner/react';
+ *
+ * const queryClient = new QueryClient();
+ *
+ * function App() {
+ *   return (
+ *     <QueryClientProvider client={queryClient}>
+ *       <SalesPlannerProvider config={{ baseUrl: '/api', apiKey: 'key' }}>
+ *         <MyApp />
+ *       </SalesPlannerProvider>
+ *     </QueryClientProvider>
+ *   );
+ * }
+ * ```
+ */
+export declare function SalesPlannerProvider({ config, children }: SalesPlannerProviderProps): import("react/jsx-runtime").JSX.Element;
+/**
+ * Returns the SalesPlannerClient instance from context.
+ * Must be used inside a SalesPlannerProvider.
+ */
+export declare function useSalesPlannerClient(): SalesPlannerClient;
+//# sourceMappingURL=provider.d.ts.map

package/dist/provider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"provider.d.ts","sourceRoot":"","sources":["../src/provider.tsx"],"names":[],"mappings":"AACA,OAAO,EAAE,kBAAkB,EAAE,MAAM,4BAA4B,CAAC;AAChE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,4BAA4B,CAAC;AAC/D,YAAY,EAAE,YAAY,EAAE,MAAM,4BAA4B,CAAC;AAI/D,MAAM,WAAW,yBAAyB;IACxC,MAAM,EAAE,YAAY,CAAC;IACrB,QAAQ,EAAE,KAAK,CAAC,SAAS,CAAC;CAC3B;AAED;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,wBAAgB,oBAAoB,CAAC,EAAE,MAAM,EAAE,QAAQ,EAAE,EAAE,yBAAyB,2CAGnF;AAED;;;GAGG;AACH,wBAAgB,qBAAqB,IAAI,kBAAkB,CAM1D"}

package/dist/provider.js

@@ -0,0 +1,41 @@
+import { jsx as _jsx } from "react/jsx-runtime";
+import { createContext, useContext } from 'react';
+import { SalesPlannerClient } from '@sales-planner/http-client';
+const SalesPlannerContext = createContext(null);
+/**
+ * Provides a SalesPlannerClient instance to all child components.
+ * Must be used inside a TanStack QueryClientProvider.
+ *
+ * @example
+ * ```tsx
+ * import { QueryClient, QueryClientProvider } from '@tanstack/react-query';
+ * import { SalesPlannerProvider } from '@sales-planner/react';
+ *
+ * const queryClient = new QueryClient();
+ *
+ * function App() {
+ *   return (
+ *     <QueryClientProvider client={queryClient}>
+ *       <SalesPlannerProvider config={{ baseUrl: '/api', apiKey: 'key' }}>
+ *         <MyApp />
+ *       </SalesPlannerProvider>
+ *     </QueryClientProvider>
+ *   );
+ * }
+ * ```
+ */
+export function SalesPlannerProvider({ config, children }) {
+    const client = new SalesPlannerClient(config);
+    return _jsx(SalesPlannerContext, { value: client, children: children });
+}
+/**
+ * Returns the SalesPlannerClient instance from context.
+ * Must be used inside a SalesPlannerProvider.
+ */
+export function useSalesPlannerClient() {
+    const client = useContext(SalesPlannerContext);
+    if (!client) {
+        throw new Error('useSalesPlannerClient must be used within a SalesPlannerProvider');
+    }
+    return client;
+}

package/dist/shop-scoped-entities.d.ts

@@ -0,0 +1,122 @@
+import type { Sku, CreateSkuRequest, ImportSkuItem, SkuExportItem, PaginationQuery, SalesHistory, CreateSalesHistoryRequest, ImportSalesHistoryItem, SalesHistoryExportItem, SalesHistoryImportResult, SalesHistoryQuery, Leftover, CreateLeftoverRequest, ImportLeftoverItem, LeftoverExportItem, ImportResult, LeftoverQuery, SeasonalCoefficient, CreateSeasonalCoefficientRequest, ImportSeasonalCoefficientItem, SeasonalCoefficientExportItem, SkuCompetitorMapping, CreateSkuCompetitorMappingRequest, ImportSkuCompetitorMappingItem, SkuCompetitorMappingExportItem, CompetitorProduct, CreateCompetitorProductRequest, ImportCompetitorProductItem, CompetitorProductExportItem, CompetitorSale, CreateCompetitorSaleRequest, ImportCompetitorSaleItem, CompetitorSaleExportItem, CompetitorProductQuery, CompetitorSaleQuery } from '@sales-planner/shared';
+export declare const skus: {
+    useList: (ctx: import("./keys.js").ShopContext, query?: PaginationQuery, options?: Omit<import("@tanstack/react-query").UseQueryOptions<import("@sales-planner/shared").PaginatedResponse<Sku>, Error, import("@sales-planner/shared").PaginatedResponse<Sku>, readonly unknown[]>, "queryKey" | "queryFn"> | undefined) => import("@tanstack/react-query").UseQueryResult<import("@sales-planner/shared").PaginatedResponse<Sku>, Error>;
+    useById: (ctx: import("./keys.js").ShopContext, id: number, options?: Omit<import("@tanstack/react-query").UseQueryOptions<Sku, Error, Sku, readonly unknown[]>, "queryKey" | "queryFn"> | undefined) => import("@tanstack/react-query").UseQueryResult<Sku, Error>;
+    useByCode: (ctx: import("./keys.js").ShopContext, code: string, options?: Omit<import("@tanstack/react-query").UseQueryOptions<Sku, Error, Sku, readonly unknown[]>, "queryKey" | "queryFn"> | undefined) => import("@tanstack/react-query").UseQueryResult<Sku, Error>;
+    useExportJson: (ctx: import("./keys.js").ShopContext, options?: Omit<import("@tanstack/react-query").UseQueryOptions<SkuExportItem[], Error, SkuExportItem[], readonly unknown[]>, "queryKey" | "queryFn"> | undefined) => import("@tanstack/react-query").UseQueryResult<SkuExportItem[], Error>;
+    useExportCsv: (ctx: import("./keys.js").ShopContext, options?: Omit<import("@tanstack/react-query").UseQueryOptions<string>, "queryKey" | "queryFn">) => import("@tanstack/react-query").UseQueryResult<string, Error>;
+    useCreate: (ctx: import("./keys.js").ShopContext, options?: Omit<import("@tanstack/react-query").UseMutationOptions<Sku, Error, CreateSkuRequest, unknown>, "mutationFn"> | undefined) => import("@tanstack/react-query").UseMutationResult<Sku, Error, CreateSkuRequest, unknown>;
+    useUpdate: (ctx: import("./keys.js").ShopContext, options?: Omit<import("@tanstack/react-query").UseMutationOptions<Sku, Error, {
+        id: number;
+        data: import("@sales-planner/shared").UpdateSkuDto;
+    }, unknown>, "mutationFn"> | undefined) => import("@tanstack/react-query").UseMutationResult<Sku, Error, {
+        id: number;
+        data: import("@sales-planner/shared").UpdateSkuDto;
+    }, unknown>;
+    useDelete: (ctx: import("./keys.js").ShopContext, options?: Omit<import("@tanstack/react-query").UseMutationOptions<void, Error, number>, "mutationFn">) => import("@tanstack/react-query").UseMutationResult<void, Error, number, unknown>;
+    useImportJson: (ctx: import("./keys.js").ShopContext, options?: Omit<import("@tanstack/react-query").UseMutationOptions<ImportResult, Error, ImportSkuItem[], unknown>, "mutationFn"> | undefined) => import("@tanstack/react-query").UseMutationResult<ImportResult, Error, ImportSkuItem[], unknown>;
+    useImportCsv: (ctx: import("./keys.js").ShopContext, options?: Omit<import("@tanstack/react-query").UseMutationOptions<ImportResult, Error, string>, "mutationFn">) => import("@tanstack/react-query").UseMutationResult<ImportResult, Error, string, unknown>;
+};
+export declare const salesHistory: {
+    useList: (ctx: import("./keys.js").ShopContext, query?: SalesHistoryQuery | undefined, options?: Omit<import("@tanstack/react-query").UseQueryOptions<import("@sales-planner/shared").PaginatedResponse<SalesHistory>, Error, import("@sales-planner/shared").PaginatedResponse<SalesHistory>, readonly unknown[]>, "queryKey" | "queryFn"> | undefined) => import("@tanstack/react-query").UseQueryResult<import("@sales-planner/shared").PaginatedResponse<SalesHistory>, Error>;
+    useById: (ctx: import("./keys.js").ShopContext, id: number, options?: Omit<import("@tanstack/react-query").UseQueryOptions<SalesHistory, Error, SalesHistory, readonly unknown[]>, "queryKey" | "queryFn"> | undefined) => import("@tanstack/react-query").UseQueryResult<SalesHistory, Error>;
+    useExportJson: (ctx: import("./keys.js").ShopContext, query?: SalesHistoryQuery | undefined, options?: Omit<import("@tanstack/react-query").UseQueryOptions<SalesHistoryExportItem[], Error, SalesHistoryExportItem[], readonly unknown[]>, "queryKey" | "queryFn"> | undefined) => import("@tanstack/react-query").UseQueryResult<SalesHistoryExportItem[], Error>;
+    useExportCsv: (ctx: import("./keys.js").ShopContext, query?: SalesHistoryQuery | undefined, options?: Omit<import("@tanstack/react-query").UseQueryOptions<string>, "queryKey" | "queryFn">) => import("@tanstack/react-query").UseQueryResult<string, Error>;
+    useCreate: (ctx: import("./keys.js").ShopContext, options?: Omit<import("@tanstack/react-query").UseMutationOptions<SalesHistory, Error, CreateSalesHistoryRequest, unknown>, "mutationFn"> | undefined) => import("@tanstack/react-query").UseMutationResult<SalesHistory, Error, CreateSalesHistoryRequest, unknown>;
+    useUpdate: (ctx: import("./keys.js").ShopContext, options?: Omit<import("@tanstack/react-query").UseMutationOptions<SalesHistory, Error, {
+        id: number;
+        data: import("@sales-planner/shared").UpdateSalesHistoryDto;
+    }, unknown>, "mutationFn"> | undefined) => import("@tanstack/react-query").UseMutationResult<SalesHistory, Error, {
+        id: number;
+        data: import("@sales-planner/shared").UpdateSalesHistoryDto;
+    }, unknown>;
+    useDelete: (ctx: import("./keys.js").ShopContext, options?: Omit<import("@tanstack/react-query").UseMutationOptions<void, Error, number>, "mutationFn">) => import("@tanstack/react-query").UseMutationResult<void, Error, number, unknown>;
+    useImportJson: (ctx: import("./keys.js").ShopContext, options?: Omit<import("@tanstack/react-query").UseMutationOptions<SalesHistoryImportResult, Error, ImportSalesHistoryItem[], unknown>, "mutationFn"> | undefined) => import("@tanstack/react-query").UseMutationResult<SalesHistoryImportResult, Error, ImportSalesHistoryItem[], unknown>;
+    useImportCsv: (ctx: import("./keys.js").ShopContext, options?: Omit<import("@tanstack/react-query").UseMutationOptions<SalesHistoryImportResult, Error, string, unknown>, "mutationFn"> | undefined) => import("@tanstack/react-query").UseMutationResult<SalesHistoryImportResult, Error, string, unknown>;
+};
+export declare const leftovers: {
+    useList: (ctx: import("./keys.js").ShopContext, query?: LeftoverQuery | undefined, options?: Omit<import("@tanstack/react-query").UseQueryOptions<import("@sales-planner/shared").PaginatedResponse<Leftover>, Error, import("@sales-planner/shared").PaginatedResponse<Leftover>, readonly unknown[]>, "queryKey" | "queryFn"> | undefined) => import("@tanstack/react-query").UseQueryResult<import("@sales-planner/shared").PaginatedResponse<Leftover>, Error>;
+    useById: (ctx: import("./keys.js").ShopContext, id: number, options?: Omit<import("@tanstack/react-query").UseQueryOptions<Leftover, Error, Leftover, readonly unknown[]>, "queryKey" | "queryFn"> | undefined) => import("@tanstack/react-query").UseQueryResult<Leftover, Error>;
+    useExportJson: (ctx: import("./keys.js").ShopContext, query?: LeftoverQuery | undefined, options?: Omit<import("@tanstack/react-query").UseQueryOptions<LeftoverExportItem[], Error, LeftoverExportItem[], readonly unknown[]>, "queryKey" | "queryFn"> | undefined) => import("@tanstack/react-query").UseQueryResult<LeftoverExportItem[], Error>;
+    useExportCsv: (ctx: import("./keys.js").ShopContext, query?: LeftoverQuery | undefined, options?: Omit<import("@tanstack/react-query").UseQueryOptions<string>, "queryKey" | "queryFn">) => import("@tanstack/react-query").UseQueryResult<string, Error>;
+    useCreate: (ctx: import("./keys.js").ShopContext, options?: Omit<import("@tanstack/react-query").UseMutationOptions<Leftover, Error, CreateLeftoverRequest, unknown>, "mutationFn"> | undefined) => import("@tanstack/react-query").UseMutationResult<Leftover, Error, CreateLeftoverRequest, unknown>;
+    useUpdate: (ctx: import("./keys.js").ShopContext, options?: Omit<import("@tanstack/react-query").UseMutationOptions<Leftover, Error, {
+        id: number;
+        data: import("@sales-planner/shared").UpdateLeftoverDto;
+    }, unknown>, "mutationFn"> | undefined) => import("@tanstack/react-query").UseMutationResult<Leftover, Error, {
+        id: number;
+        data: import("@sales-planner/shared").UpdateLeftoverDto;
+    }, unknown>;
+    useDelete: (ctx: import("./keys.js").ShopContext, options?: Omit<import("@tanstack/react-query").UseMutationOptions<void, Error, number>, "mutationFn">) => import("@tanstack/react-query").UseMutationResult<void, Error, number, unknown>;
+    useImportJson: (ctx: import("./keys.js").ShopContext, options?: Omit<import("@tanstack/react-query").UseMutationOptions<ImportResult, Error, ImportLeftoverItem[], unknown>, "mutationFn"> | undefined) => import("@tanstack/react-query").UseMutationResult<ImportResult, Error, ImportLeftoverItem[], unknown>;
+    useImportCsv: (ctx: import("./keys.js").ShopContext, options?: Omit<import("@tanstack/react-query").UseMutationOptions<ImportResult, Error, string, unknown>, "mutationFn"> | undefined) => import("@tanstack/react-query").UseMutationResult<ImportResult, Error, string, unknown>;
+};
+export declare const seasonalCoefficients: {
+    useList: (ctx: import("./keys.js").ShopContext, query?: PaginationQuery | undefined, options?: Omit<import("@tanstack/react-query").UseQueryOptions<import("@sales-planner/shared").PaginatedResponse<SeasonalCoefficient>, Error, import("@sales-planner/shared").PaginatedResponse<SeasonalCoefficient>, readonly unknown[]>, "queryKey" | "queryFn"> | undefined) => import("@tanstack/react-query").UseQueryResult<import("@sales-planner/shared").PaginatedResponse<SeasonalCoefficient>, Error>;
+    useById: (ctx: import("./keys.js").ShopContext, id: number, options?: Omit<import("@tanstack/react-query").UseQueryOptions<SeasonalCoefficient, Error, SeasonalCoefficient, readonly unknown[]>, "queryKey" | "queryFn"> | undefined) => import("@tanstack/react-query").UseQueryResult<SeasonalCoefficient, Error>;
+    useExportJson: (ctx: import("./keys.js").ShopContext, query?: PaginationQuery | undefined, options?: Omit<import("@tanstack/react-query").UseQueryOptions<SeasonalCoefficientExportItem[], Error, SeasonalCoefficientExportItem[], readonly unknown[]>, "queryKey" | "queryFn"> | undefined) => import("@tanstack/react-query").UseQueryResult<SeasonalCoefficientExportItem[], Error>;
+    useExportCsv: (ctx: import("./keys.js").ShopContext, query?: PaginationQuery | undefined, options?: Omit<import("@tanstack/react-query").UseQueryOptions<string>, "queryKey" | "queryFn">) => import("@tanstack/react-query").UseQueryResult<string, Error>;
+    useCreate: (ctx: import("./keys.js").ShopContext, options?: Omit<import("@tanstack/react-query").UseMutationOptions<SeasonalCoefficient, Error, CreateSeasonalCoefficientRequest, unknown>, "mutationFn"> | undefined) => import("@tanstack/react-query").UseMutationResult<SeasonalCoefficient, Error, CreateSeasonalCoefficientRequest, unknown>;
+    useUpdate: (ctx: import("./keys.js").ShopContext, options?: Omit<import("@tanstack/react-query").UseMutationOptions<SeasonalCoefficient, Error, {
+        id: number;
+        data: import("@sales-planner/shared").UpdateSeasonalCoefficientDto;
+    }, unknown>, "mutationFn"> | undefined) => import("@tanstack/react-query").UseMutationResult<SeasonalCoefficient, Error, {
+        id: number;
+        data: import("@sales-planner/shared").UpdateSeasonalCoefficientDto;
+    }, unknown>;
+    useDelete: (ctx: import("./keys.js").ShopContext, options?: Omit<import("@tanstack/react-query").UseMutationOptions<void, Error, number>, "mutationFn">) => import("@tanstack/react-query").UseMutationResult<void, Error, number, unknown>;
+    useImportJson: (ctx: import("./keys.js").ShopContext, options?: Omit<import("@tanstack/react-query").UseMutationOptions<ImportResult, Error, ImportSeasonalCoefficientItem[], unknown>, "mutationFn"> | undefined) => import("@tanstack/react-query").UseMutationResult<ImportResult, Error, ImportSeasonalCoefficientItem[], unknown>;
+    useImportCsv: (ctx: import("./keys.js").ShopContext, options?: Omit<import("@tanstack/react-query").UseMutationOptions<ImportResult, Error, string, unknown>, "mutationFn"> | undefined) => import("@tanstack/react-query").UseMutationResult<ImportResult, Error, string, unknown>;
+};
+export declare const skuCompetitorMappings: {
+    useList: (ctx: import("./keys.js").ShopContext, query?: PaginationQuery | undefined, options?: Omit<import("@tanstack/react-query").UseQueryOptions<import("@sales-planner/shared").PaginatedResponse<SkuCompetitorMapping>, Error, import("@sales-planner/shared").PaginatedResponse<SkuCompetitorMapping>, readonly unknown[]>, "queryKey" | "queryFn"> | undefined) => import("@tanstack/react-query").UseQueryResult<import("@sales-planner/shared").PaginatedResponse<SkuCompetitorMapping>, Error>;
+    useById: (ctx: import("./keys.js").ShopContext, id: number, options?: Omit<import("@tanstack/react-query").UseQueryOptions<SkuCompetitorMapping, Error, SkuCompetitorMapping, readonly unknown[]>, "queryKey" | "queryFn"> | undefined) => import("@tanstack/react-query").UseQueryResult<SkuCompetitorMapping, Error>;
+    useExportJson: (ctx: import("./keys.js").ShopContext, query?: PaginationQuery | undefined, options?: Omit<import("@tanstack/react-query").UseQueryOptions<SkuCompetitorMappingExportItem[], Error, SkuCompetitorMappingExportItem[], readonly unknown[]>, "queryKey" | "queryFn"> | undefined) => import("@tanstack/react-query").UseQueryResult<SkuCompetitorMappingExportItem[], Error>;
+    useExportCsv: (ctx: import("./keys.js").ShopContext, query?: PaginationQuery | undefined, options?: Omit<import("@tanstack/react-query").UseQueryOptions<string>, "queryKey" | "queryFn">) => import("@tanstack/react-query").UseQueryResult<string, Error>;
+    useCreate: (ctx: import("./keys.js").ShopContext, options?: Omit<import("@tanstack/react-query").UseMutationOptions<SkuCompetitorMapping, Error, CreateSkuCompetitorMappingRequest, unknown>, "mutationFn"> | undefined) => import("@tanstack/react-query").UseMutationResult<SkuCompetitorMapping, Error, CreateSkuCompetitorMappingRequest, unknown>;
+    useUpdate: (ctx: import("./keys.js").ShopContext, options?: Omit<import("@tanstack/react-query").UseMutationOptions<SkuCompetitorMapping, Error, {
+        id: number;
+        data: import("@sales-planner/shared").UpdateSkuCompetitorMappingDto;
+    }, unknown>, "mutationFn"> | undefined) => import("@tanstack/react-query").UseMutationResult<SkuCompetitorMapping, Error, {
+        id: number;
+        data: import("@sales-planner/shared").UpdateSkuCompetitorMappingDto;
+    }, unknown>;
+    useDelete: (ctx: import("./keys.js").ShopContext, options?: Omit<import("@tanstack/react-query").UseMutationOptions<void, Error, number>, "mutationFn">) => import("@tanstack/react-query").UseMutationResult<void, Error, number, unknown>;
+    useImportJson: (ctx: import("./keys.js").ShopContext, options?: Omit<import("@tanstack/react-query").UseMutationOptions<ImportResult, Error, ImportSkuCompetitorMappingItem[], unknown>, "mutationFn"> | undefined) => import("@tanstack/react-query").UseMutationResult<ImportResult, Error, ImportSkuCompetitorMappingItem[], unknown>;
+    useImportCsv: (ctx: import("./keys.js").ShopContext, options?: Omit<import("@tanstack/react-query").UseMutationOptions<ImportResult, Error, string, unknown>, "mutationFn"> | undefined) => import("@tanstack/react-query").UseMutationResult<ImportResult, Error, string, unknown>;
+};
+export declare const competitorProducts: {
+    useList: (ctx: import("./keys.js").ShopContext, query?: CompetitorProductQuery | undefined, options?: Omit<import("@tanstack/react-query").UseQueryOptions<import("@sales-planner/shared").PaginatedResponse<CompetitorProduct>, Error, import("@sales-planner/shared").PaginatedResponse<CompetitorProduct>, readonly unknown[]>, "queryKey" | "queryFn"> | undefined) => import("@tanstack/react-query").UseQueryResult<import("@sales-planner/shared").PaginatedResponse<CompetitorProduct>, Error>;
+    useById: (ctx: import("./keys.js").ShopContext, id: number, options?: Omit<import("@tanstack/react-query").UseQueryOptions<CompetitorProduct, Error, CompetitorProduct, readonly unknown[]>, "queryKey" | "queryFn"> | undefined) => import("@tanstack/react-query").UseQueryResult<CompetitorProduct, Error>;
+    useExportJson: (ctx: import("./keys.js").ShopContext, query?: CompetitorProductQuery | undefined, options?: Omit<import("@tanstack/react-query").UseQueryOptions<CompetitorProductExportItem[], Error, CompetitorProductExportItem[], readonly unknown[]>, "queryKey" | "queryFn"> | undefined) => import("@tanstack/react-query").UseQueryResult<CompetitorProductExportItem[], Error>;
+    useExportCsv: (ctx: import("./keys.js").ShopContext, query?: CompetitorProductQuery | undefined, options?: Omit<import("@tanstack/react-query").UseQueryOptions<string>, "queryKey" | "queryFn">) => import("@tanstack/react-query").UseQueryResult<string, Error>;
+    useCreate: (ctx: import("./keys.js").ShopContext, options?: Omit<import("@tanstack/react-query").UseMutationOptions<CompetitorProduct, Error, CreateCompetitorProductRequest, unknown>, "mutationFn"> | undefined) => import("@tanstack/react-query").UseMutationResult<CompetitorProduct, Error, CreateCompetitorProductRequest, unknown>;
+    useUpdate: (ctx: import("./keys.js").ShopContext, options?: Omit<import("@tanstack/react-query").UseMutationOptions<CompetitorProduct, Error, {
+        id: number;
+        data: import("@sales-planner/shared").UpdateCompetitorProductDto;
+    }, unknown>, "mutationFn"> | undefined) => import("@tanstack/react-query").UseMutationResult<CompetitorProduct, Error, {
+        id: number;
+        data: import("@sales-planner/shared").UpdateCompetitorProductDto;
+    }, unknown>;
+    useDelete: (ctx: import("./keys.js").ShopContext, options?: Omit<import("@tanstack/react-query").UseMutationOptions<void, Error, number>, "mutationFn">) => import("@tanstack/react-query").UseMutationResult<void, Error, number, unknown>;
+    useImportJson: (ctx: import("./keys.js").ShopContext, options?: Omit<import("@tanstack/react-query").UseMutationOptions<ImportResult, Error, ImportCompetitorProductItem[], unknown>, "mutationFn"> | undefined) => import("@tanstack/react-query").UseMutationResult<ImportResult, Error, ImportCompetitorProductItem[], unknown>;
+    useImportCsv: (ctx: import("./keys.js").ShopContext, options?: Omit<import("@tanstack/react-query").UseMutationOptions<ImportResult, Error, string, unknown>, "mutationFn"> | undefined) => import("@tanstack/react-query").UseMutationResult<ImportResult, Error, string, unknown>;
+};
+export declare const competitorSales: {
+    useList: (ctx: import("./keys.js").ShopContext, query?: CompetitorSaleQuery | undefined, options?: Omit<import("@tanstack/react-query").UseQueryOptions<import("@sales-planner/shared").PaginatedResponse<CompetitorSale>, Error, import("@sales-planner/shared").PaginatedResponse<CompetitorSale>, readonly unknown[]>, "queryKey" | "queryFn"> | undefined) => import("@tanstack/react-query").UseQueryResult<import("@sales-planner/shared").PaginatedResponse<CompetitorSale>, Error>;
+    useById: (ctx: import("./keys.js").ShopContext, id: number, options?: Omit<import("@tanstack/react-query").UseQueryOptions<CompetitorSale, Error, CompetitorSale, readonly unknown[]>, "queryKey" | "queryFn"> | undefined) => import("@tanstack/react-query").UseQueryResult<CompetitorSale, Error>;
+    useExportJson: (ctx: import("./keys.js").ShopContext, query?: CompetitorSaleQuery | undefined, options?: Omit<import("@tanstack/react-query").UseQueryOptions<CompetitorSaleExportItem[], Error, CompetitorSaleExportItem[], readonly unknown[]>, "queryKey" | "queryFn"> | undefined) => import("@tanstack/react-query").UseQueryResult<CompetitorSaleExportItem[], Error>;
+    useExportCsv: (ctx: import("./keys.js").ShopContext, query?: CompetitorSaleQuery | undefined, options?: Omit<import("@tanstack/react-query").UseQueryOptions<string>, "queryKey" | "queryFn">) => import("@tanstack/react-query").UseQueryResult<string, Error>;
+    useCreate: (ctx: import("./keys.js").ShopContext, options?: Omit<import("@tanstack/react-query").UseMutationOptions<CompetitorSale, Error, CreateCompetitorSaleRequest, unknown>, "mutationFn"> | undefined) => import("@tanstack/react-query").UseMutationResult<CompetitorSale, Error, CreateCompetitorSaleRequest, unknown>;
+    useUpdate: (ctx: import("./keys.js").ShopContext, options?: Omit<import("@tanstack/react-query").UseMutationOptions<CompetitorSale, Error, {
+        id: number;
+        data: import("@sales-planner/shared").UpdateCompetitorSaleDto;
+    }, unknown>, "mutationFn"> | undefined) => import("@tanstack/react-query").UseMutationResult<CompetitorSale, Error, {
+        id: number;
+        data: import("@sales-planner/shared").UpdateCompetitorSaleDto;
+    }, unknown>;
+    useDelete: (ctx: import("./keys.js").ShopContext, options?: Omit<import("@tanstack/react-query").UseMutationOptions<void, Error, number>, "mutationFn">) => import("@tanstack/react-query").UseMutationResult<void, Error, number, unknown>;
+    useImportJson: (ctx: import("./keys.js").ShopContext, options?: Omit<import("@tanstack/react-query").UseMutationOptions<ImportResult, Error, ImportCompetitorSaleItem[], unknown>, "mutationFn"> | undefined) => import("@tanstack/react-query").UseMutationResult<ImportResult, Error, ImportCompetitorSaleItem[], unknown>;
+    useImportCsv: (ctx: import("./keys.js").ShopContext, options?: Omit<import("@tanstack/react-query").UseMutationOptions<ImportResult, Error, string, unknown>, "mutationFn"> | undefined) => import("@tanstack/react-query").UseMutationResult<ImportResult, Error, string, unknown>;
+};
+//# sourceMappingURL=shop-scoped-entities.d.ts.map

package/dist/shop-scoped-entities.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"shop-scoped-entities.d.ts","sourceRoot":"","sources":["../src/shop-scoped-entities.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,GAAG,EACH,gBAAgB,EAEhB,aAAa,EACb,aAAa,EACb,eAAe,EACf,YAAY,EACZ,yBAAyB,EAEzB,sBAAsB,EACtB,sBAAsB,EACtB,wBAAwB,EACxB,iBAAiB,EACjB,QAAQ,EACR,qBAAqB,EAErB,kBAAkB,EAClB,kBAAkB,EAClB,YAAY,EACZ,aAAa,EACb,mBAAmB,EACnB,gCAAgC,EAEhC,6BAA6B,EAC7B,6BAA6B,EAC7B,oBAAoB,EACpB,iCAAiC,EAEjC,8BAA8B,EAC9B,8BAA8B,EAC9B,iBAAiB,EACjB,8BAA8B,EAE9B,2BAA2B,EAC3B,2BAA2B,EAC3B,cAAc,EACd,2BAA2B,EAE3B,wBAAwB,EACxB,wBAAwB,EACxB,sBAAsB,EACtB,mBAAmB,EACpB,MAAM,uBAAuB,CAAC;AAK/B,eAAO,MAAM,IAAI;;;;;;;;;;;;;;;;;CAMO,CAAC;AAEzB,eAAO,MAAM,YAAY;;;;;;;;;;;;;;;;CAQgB,CAAC;AAE1C,eAAO,MAAM,SAAS;;;;;;;;;;;;;;;;CAQY,CAAC;AAEnC,eAAO,MAAM,oBAAoB;;;;;;;;;;;;;;;;CAQwB,CAAC;AAE1D,eAAO,MAAM,qBAAqB;;;;;;;;;;;;;;;;CAQ0B,CAAC;AAE7D,eAAO,MAAM,kBAAkB;;;;;;;;;;;;;;;;CAQsB,CAAC;AAEtD,eAAO,MAAM,eAAe;;;;;;;;;;;;;;;;CAQmB,CAAC"}

package/dist/shop-scoped-entities.js

@@ -0,0 +1,10 @@
+import { createShopScopedHooks } from './create-shop-scoped-hooks.js';
+import { createCodedEntityHooks } from './create-coded-entity-hooks.js';
+// SKUs use a custom client, but the interface is the same as CodedEntityClient
+export const skus = createCodedEntityHooks('skus', (c) => c.skus);
+export const salesHistory = createShopScopedHooks('sales-history', (c) => c.salesHistory);
+export const leftovers = createShopScopedHooks('leftovers', (c) => c.leftovers);
+export const seasonalCoefficients = createShopScopedHooks('seasonal-coefficients', (c) => c.seasonalCoefficients);
+export const skuCompetitorMappings = createShopScopedHooks('sku-competitor-mappings', (c) => c.skuCompetitorMappings);
+export const competitorProducts = createShopScopedHooks('competitor-products', (c) => c.competitorProducts);
+export const competitorSales = createShopScopedHooks('competitor-sales', (c) => c.competitorSales);

package/dist/specialized.d.ts

@@ -0,0 +1,28 @@
+import type { UseQueryOptions, UseMutationOptions } from '@tanstack/react-query';
+import type { UserWithRolesAndTenants, EntitiesMetadata, PaginatedResponse, PaginationQuery, SkuMetrics } from '@sales-planner/shared';
+import type { ShopContext } from './keys.js';
+/** Info about a materialized view */
+export interface ViewInfo {
+    name: string;
+    description: string;
+}
+/** Result of refreshing all materialized views */
+export interface RefreshAllResult {
+    results: Array<{
+        view: string;
+        duration: number;
+        success: boolean;
+        error?: string;
+    }>;
+    totalDuration: number;
+    success: boolean;
+}
+export declare function useMe(options?: Omit<UseQueryOptions<UserWithRolesAndTenants>, 'queryKey' | 'queryFn'>): import("@tanstack/react-query").UseQueryResult<UserWithRolesAndTenants, Error>;
+export declare function useEntitiesMetadata(options?: Omit<UseQueryOptions<EntitiesMetadata>, 'queryKey' | 'queryFn'>): import("@tanstack/react-query").UseQueryResult<EntitiesMetadata, Error>;
+export declare function useSkuMetrics(ctx: ShopContext, query?: PaginationQuery, options?: Omit<UseQueryOptions<PaginatedResponse<SkuMetrics>>, 'queryKey' | 'queryFn'>): import("@tanstack/react-query").UseQueryResult<PaginatedResponse<SkuMetrics>, Error>;
+export declare function useSkuMetricsById(ctx: ShopContext, id: number, options?: Omit<UseQueryOptions<SkuMetrics>, 'queryKey' | 'queryFn'>): import("@tanstack/react-query").UseQueryResult<SkuMetrics, Error>;
+export declare function useSkuMetricsByAbcClass(ctx: ShopContext, abcClass: 'A' | 'B' | 'C', options?: Omit<UseQueryOptions<SkuMetrics[]>, 'queryKey' | 'queryFn'>): import("@tanstack/react-query").UseQueryResult<SkuMetrics[], Error>;
+export declare function useSkuMetricsExportCsv(ctx: ShopContext, options?: Omit<UseQueryOptions<string>, 'queryKey' | 'queryFn'>): import("@tanstack/react-query").UseQueryResult<string, Error>;
+export declare function useComputedViews(ctx: ShopContext, options?: Omit<UseQueryOptions<ViewInfo[]>, 'queryKey' | 'queryFn'>): import("@tanstack/react-query").UseQueryResult<ViewInfo[], Error>;
+export declare function useRefreshAllViews(ctx: ShopContext, options?: Omit<UseMutationOptions<RefreshAllResult, Error, void>, 'mutationFn'>): import("@tanstack/react-query").UseMutationResult<RefreshAllResult, Error, void, unknown>;
+//# sourceMappingURL=specialized.d.ts.map

package/dist/specialized.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"specialized.d.ts","sourceRoot":"","sources":["../src/specialized.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,eAAe,EAAE,kBAAkB,EAAE,MAAM,uBAAuB,CAAC;AACjF,OAAO,KAAK,EACV,uBAAuB,EACvB,gBAAgB,EAChB,iBAAiB,EACjB,eAAe,EACf,UAAU,EACX,MAAM,uBAAuB,CAAC;AAG/B,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,WAAW,CAAC;AAE7C,qCAAqC;AACrC,MAAM,WAAW,QAAQ;IACvB,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;CACrB;AAED,kDAAkD;AAClD,MAAM,WAAW,gBAAgB;IAC/B,OAAO,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,OAAO,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IACrF,aAAa,EAAE,MAAM,CAAC;IACtB,OAAO,EAAE,OAAO,CAAC;CAClB;AAID,wBAAgB,KAAK,CACnB,OAAO,CAAC,EAAE,IAAI,CAAC,eAAe,CAAC,uBAAuB,CAAC,EAAE,UAAU,GAAG,SAAS,CAAC,kFAQjF;AAID,wBAAgB,mBAAmB,CACjC,OAAO,CAAC,EAAE,IAAI,CAAC,eAAe,CAAC,gBAAgB,CAAC,EAAE,UAAU,GAAG,SAAS,CAAC,2EAS1E;AAID,wBAAgB,aAAa,CAC3B,GAAG,EAAE,WAAW,EAChB,KAAK,CAAC,EAAE,eAAe,EACvB,OAAO,CAAC,EAAE,IAAI,CAAC,eAAe,CAAC,iBAAiB,CAAC,UAAU,CAAC,CAAC,EAAE,UAAU,GAAG,SAAS,CAAC,wFAQvF;AAED,wBAAgB,iBAAiB,CAC/B,GAAG,EAAE,WAAW,EAChB,EAAE,EAAE,MAAM,EACV,OAAO,CAAC,EAAE,IAAI,CAAC,eAAe,CAAC,UAAU,CAAC,EAAE,UAAU,GAAG,SAAS,CAAC,qEAQpE;AAED,wBAAgB,uBAAuB,CACrC,GAAG,EAAE,WAAW,EAChB,QAAQ,EAAE,GAAG,GAAG,GAAG,GAAG,GAAG,EACzB,OAAO,CAAC,EAAE,IAAI,CAAC,eAAe,CAAC,UAAU,EAAE,CAAC,EAAE,UAAU,GAAG,SAAS,CAAC,uEAQtE;AAED,wBAAgB,sBAAsB,CACpC,GAAG,EAAE,WAAW,EAChB,OAAO,CAAC,EAAE,IAAI,CAAC,eAAe,CAAC,MAAM,CAAC,EAAE,UAAU,GAAG,SAAS,CAAC,iEAShE;AAID,wBAAgB,gBAAgB,CAC9B,GAAG,EAAE,WAAW,EAChB,OAAO,CAAC,EAAE,IAAI,CAAC,eAAe,CAAC,QAAQ,EAAE,CAAC,EAAE,UAAU,GAAG,SAAS,CAAC,qEAQpE;AAED,wBAAgB,kBAAkB,CAChC,GAAG,EAAE,WAAW,EAChB,OAAO,CAAC,EAAE,IAAI,CAAC,kBAAkB,CAAC,gBAAgB,EAAE,KAAK,EAAE,IAAI,CAAC,EAAE,YAAY,CAAC,6FAYhF"}

package/dist/specialized.js

@@ -0,0 +1,77 @@
+import { useQuery, useMutation, useQueryClient } from '@tanstack/react-query';
+import { useSalesPlannerClient } from './provider.js';
+import { queryKeys } from './keys.js';
+// ── Me ──
+export function useMe(options) {
+    const client = useSalesPlannerClient();
+    return useQuery({
+        queryKey: queryKeys.me(),
+        queryFn: () => client.me.getMe(),
+        ...options,
+    });
+}
+// ── Metadata ──
+export function useEntitiesMetadata(options) {
+    const client = useSalesPlannerClient();
+    return useQuery({
+        queryKey: queryKeys.metadata(),
+        queryFn: () => client.metadata.getEntitiesMetadata(),
+        staleTime: Number.POSITIVE_INFINITY, // metadata rarely changes
+        ...options,
+    });
+}
+// ── SKU Metrics ──
+export function useSkuMetrics(ctx, query, options) {
+    const client = useSalesPlannerClient();
+    return useQuery({
+        queryKey: queryKeys.skuMetricsList(ctx, query),
+        queryFn: () => client.skuMetrics.list(ctx.shopId, ctx.tenantId, query),
+        ...options,
+    });
+}
+export function useSkuMetricsById(ctx, id, options) {
+    const client = useSalesPlannerClient();
+    return useQuery({
+        queryKey: queryKeys.skuMetricsDetail(ctx, id),
+        queryFn: () => client.skuMetrics.get(id, ctx.shopId, ctx.tenantId),
+        ...options,
+    });
+}
+export function useSkuMetricsByAbcClass(ctx, abcClass, options) {
+    const client = useSalesPlannerClient();
+    return useQuery({
+        queryKey: queryKeys.skuMetricsAbc(ctx, abcClass),
+        queryFn: () => client.skuMetrics.getByAbcClass(abcClass, ctx.shopId, ctx.tenantId),
+        ...options,
+    });
+}
+export function useSkuMetricsExportCsv(ctx, options) {
+    const client = useSalesPlannerClient();
+    return useQuery({
+        queryKey: [...queryKeys.skuMetrics(ctx), 'export', 'csv'],
+        queryFn: () => client.skuMetrics.exportCsv(ctx.shopId, ctx.tenantId),
+        enabled: false,
+        ...options,
+    });
+}
+// ── Computed Entities (Materialized Views) ──
+export function useComputedViews(ctx, options) {
+    const client = useSalesPlannerClient();
+    return useQuery({
+        queryKey: [...queryKeys.computed(ctx), 'views'],
+        queryFn: () => client.computed.getViews(ctx.shopId, ctx.tenantId),
+        ...options,
+    });
+}
+export function useRefreshAllViews(ctx, options) {
+    const client = useSalesPlannerClient();
+    const queryClient = useQueryClient();
+    return useMutation({
+        mutationFn: () => client.computed.refreshAll(ctx.shopId, ctx.tenantId),
+        onSuccess: () => {
+            // Refresh sku-metrics cache since views were refreshed
+            queryClient.invalidateQueries({ queryKey: queryKeys.skuMetrics(ctx) });
+        },
+        ...options,
+    });
+}

package/package.json

@@ -0,0 +1,48 @@
+{
+  "name": "@sales-planner/react",
+  "version": "0.2.0",
+  "description": "React hooks for Sales Planner API powered by TanStack Query",
+  "author": "Damir Manapov",
+  "license": "MIT",
+  "keywords": [
+    "sales-planner",
+    "react",
+    "hooks",
+    "tanstack-query",
+    "react-query"
+  ],
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist",
+    "README.md"
+  ],
+  "dependencies": {
+    "@sales-planner/http-client": "0.19.2",
+    "@sales-planner/shared": "0.17.2"
+  },
+  "peerDependencies": {
+    "@tanstack/react-query": ">=5.0.0",
+    "react": ">=18.0.0"
+  },
+  "devDependencies": {
+    "@tanstack/react-query": "^5.80.7",
+    "@types/react": "^19.1.8",
+    "react": "^19.1.0",
+    "typescript": "^5.7.3"
+  },
+  "scripts": {
+    "build": "tsc",
+    "typecheck": "tsc --noEmit",
+    "lint": "biome lint --error-on-warnings src",
+    "format": "biome format --write src",
+    "format:check": "biome format src"
+  }
+}