@sales-planner/react 0.2.0 → 0.2.2

package/README.md

@@ -84,46 +84,183 @@ function ImportSuppliers() {
 }
 ```
 
-## Available Hooks
+## API Reference
 
-### Coded entities
+### Provider
+
+| Export | Description |
+| --- | --- |
+| `SalesPlannerProvider` | React context provider — accepts `config` and `children` |
+| `useSalesPlannerClient()` | Returns the underlying `SalesPlannerClient` for direct API access |
+| `ClientConfig` | Type — `{ baseUrl: string; apiKey?: string }` |
+
+### Coded entity hooks
 
 `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)
+| Hook | Kind | Description |
+| --- | --- | --- |
+| `.useList(ctx, query?)` | query | Paginated list |
+| `.useById(ctx, id)` | query | Single entity by ID |
+| `.useByCode(ctx, code)` | query | Lookup by code |
+| `.useExportJson(ctx)` | query | JSON export (`enabled: false`, manual trigger) |
+| `.useExportCsv(ctx)` | query | CSV export (`enabled: false`, manual trigger) |
+| `.useExampleJson()` | query | Example JSON (public, `staleTime: Infinity`) |
+| `.useExampleCsv()` | query | Example CSV (public, `staleTime: Infinity`) |
+| `.useCreate(ctx)` | mutation | Create entity |
+| `.useUpdate(ctx)` | mutation | Update entity (`{ id, data }`) |
+| `.useDelete(ctx)` | mutation | Delete entity by ID |
+| `.useImportJson(ctx)` | mutation | Bulk import from JSON |
+| `.useImportCsv(ctx)` | mutation | Bulk import from CSV |
+
+`ctx` is `ShopContext` — `{ shopId: number; tenantId: number }`.
+
+### Shop-scoped entity hooks
+
+`salesHistory`, `leftovers`, `seasonalCoefficients`, `skuCompetitorMappings`, `competitorProducts`, `competitorSales` — same as coded entities **without** `.useByCode`.
+
+### Specialized hooks
+
+| Hook | Kind | Description |
+| --- | --- | --- |
+| `useMe(options?)` | query | Current user with roles and tenants |
+| `useEntitiesMetadata(options?)` | query | Entity field metadata (`staleTime: Infinity`) |
+| `useSkuMetrics(ctx, query?, options?)` | query | Paginated SKU metrics |
+| `useSkuMetricsById(ctx, id, options?)` | query | Single SKU metric |
+| `useSkuMetricsByAbcClass(ctx, 'A'\|'B'\|'C', options?)` | query | SKU metrics filtered by ABC class |
+| `useSkuMetricsExportCsv(ctx, options?)` | query | CSV export (`enabled: false`, manual trigger) |
+| `useComputedViews(ctx, options?)` | query | List materialized views |
+| `useRefreshAllViews(ctx, options?)` | mutation | Refresh all views (auto-invalidates `skuMetrics`) |
+
+### Admin hooks
+
+#### Tenants
+
+| Hook | Kind | Description |
+| --- | --- | --- |
+| `useTenants(query?)` | query | Paginated list (filterable by `owner_id`) |
+| `useTenantById(id)` | query | Single tenant |
+| `useCreateTenant()` | mutation | Create tenant (SysAdmin) |
+| `useCreateTenantWithShopAndUser()` | mutation | Create tenant + shop + user + API key (SysAdmin) |
+| `useUpdateTenant()` | mutation | Update tenant (`{ id, data }`) |
+| `useDeleteTenant()` | mutation | Delete tenant (SysAdmin) |
+
+#### Users
+
+| Hook | Kind | Description |
+| --- | --- | --- |
+| `useUsers(query?)` | query | Paginated list (filterable by `tenantId`) |
+| `useUserById(id)` | query | Single user |
+| `useCreateUser()` | mutation | Create user |
+| `useDeleteUser()` | mutation | Delete user |
+
+#### Shops
+
+| Hook | Kind | Description |
+| --- | --- | --- |
+| `useShops(query?)` | query | Paginated list (filterable by `tenantId`) |
+| `useShopById(id)` | query | Single shop |
+| `useCreateShop()` | mutation | Create shop |
+| `useUpdateShop()` | mutation | Update shop (`{ id, data }`) |
+
+#### Roles (predefined, read-only)
+
+| Hook | Kind | Description |
+| --- | --- | --- |
+| `useRoles(query?)` | query | Paginated list |
+| `useRoleById(id)` | query | Single role |
+
+#### User Roles
+
+| Hook | Kind | Description |
+| --- | --- | --- |
+| `useUserRoles(query?)` | query | Paginated list (filterable by `userId`, `roleId`, `tenantId`) |
+| `useUserRoleById(id)` | query | Single user-role assignment |
+| `useCreateUserRole()` | mutation | Assign role to user |
+| `useDeleteUserRole()` | mutation | Remove role from user |
+
+#### User Shops
+
+| Hook | Kind | Description |
+| --- | --- | --- |
+| `useUserShops(query?)` | query | List (filterable by `userId`, `shopId`, `tenantId`) |
+| `useUserShopById(id)` | query | Single user-shop assignment |
+| `useCreateUserShop()` | mutation | Assign user to shop |
+| `useDeleteUserShop()` | mutation | Remove user from shop |
+
+#### API Keys
+
+| Hook | Kind | Description |
+| --- | --- | --- |
+| `useApiKeys(query?)` | query | Paginated list (filterable by `user_id`) |
+| `useCreateApiKey()` | mutation | Create API key |
+| `useRevokeApiKey()` | mutation | Revoke (delete) API key |
+
+### Utilities
+
+| Export | Description |
+| --- | --- |
+| `queryKeys` | Query key factory for custom cache management |
+| `ShopContext` | Type — `{ shopId: number; tenantId: number }` |
+| `toShopContextParams(ctx)` | Converts `ShopContext` to `ShopContextParams` |
+| `createCodedEntityHooks(name, accessor)` | Factory — build your own coded entity hook set |
+| `createShopScopedHooks(name, accessor)` | Factory — build your own shop-scoped hook set |
+
+### Query keys
 
-### Shop-scoped entities
+All keys start with `'sales-planner'`. Use `queryKeys` for custom invalidation:
 
-`salesHistory`, `leftovers`, `seasonalCoefficients`, `skuCompetitorMappings`, `competitorProducts`, `competitorSales` — same as above minus `useByCode`.
+```tsx
+import { queryKeys } from '@sales-planner/react';
+import { useQueryClient } from '@tanstack/react-query';
+
+const qc = useQueryClient();
 
-### Specialized
+// Invalidate all SKU queries
+qc.invalidateQueries({ queryKey: queryKeys.entity('skus', ctx) });
+```
 
-- `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
+Available keys:
+
+| Key | Arguments | Purpose |
+| --- | --- | --- |
+| `queryKeys.me()` | — | Current user |
+| `queryKeys.metadata()` | — | Entity metadata |
+| `queryKeys.tenants(query?)` | pagination + owner_id | Tenants list |
+| `queryKeys.tenantDetail(id)` | id | Single tenant |
+| `queryKeys.users(query?)` | pagination + tenantId | Users list |
+| `queryKeys.userDetail(id)` | id | Single user |
+| `queryKeys.shops(query?)` | pagination + tenantId | Shops list |
+| `queryKeys.shopDetail(id)` | id | Single shop |
+| `queryKeys.roles(query?)` | pagination | Roles list |
+| `queryKeys.roleDetail(id)` | id | Single role |
+| `queryKeys.userRoles(query?)` | userId, roleId, tenantId | User-role assignments |
+| `queryKeys.userRoleDetail(id)` | id | Single user-role |
+| `queryKeys.userShops(query?)` | userId, shopId, tenantId | User-shop assignments |
+| `queryKeys.userShopDetail(id)` | id | Single user-shop |
+| `queryKeys.apiKeys(query?)` | pagination + user_id | API keys list |
+| `queryKeys.apiKeyDetail(id)` | id | Single API key |
+| `queryKeys.entity(name, ctx)` | entity name, shop context | Root key for a data entity |
+| `queryKeys.entityList(name, ctx, query?)` | entity, ctx, pagination | Paginated list |
+| `queryKeys.entityDetail(name, ctx, id)` | entity, ctx, id | Single entity |
+| `queryKeys.entityByCode(name, ctx, code)` | entity, ctx, code | Code lookup |
+| `queryKeys.entityExport(name, ctx, format)` | entity, ctx, `'json'\|'csv'` | Export |
+| `queryKeys.entityExample(name, format)` | entity, `'json'\|'csv'` | Example (no ctx — public) |
+| `queryKeys.skuMetrics(ctx)` | ctx | SKU metrics root |
+| `queryKeys.skuMetricsList(ctx, query?)` | ctx, pagination | SKU metrics list |
+| `queryKeys.skuMetricsDetail(ctx, id)` | ctx, id | Single SKU metric |
+| `queryKeys.skuMetricsAbc(ctx, class)` | ctx, `'A'\|'B'\|'C'` | ABC class filter |
+| `queryKeys.computed(ctx)` | ctx | Computed views root |
 
 ## Cache Invalidation
 
-All mutations automatically invalidate related query caches. The `queryKeys` object is exported for custom cache management:
+All mutations automatically invalidate their related query caches. `useRefreshAllViews` additionally invalidates `skuMetrics`.
 
-```tsx
-import { queryKeys } from '@sales-planner/react';
-import { useQueryClient } from '@tanstack/react-query';
+## Related Packages
 
-const queryClient = useQueryClient();
-queryClient.invalidateQueries({ queryKey: queryKeys.entity('skus', ctx) });
-```
+- `@sales-planner/shared` — TypeScript types
+- `@sales-planner/http-client` — HTTP client (included as dependency)
+
+## License
+
+MIT

package/dist/admin.d.ts

@@ -0,0 +1,57 @@
+import type { UseQueryOptions, UseMutationOptions } from '@tanstack/react-query';
+import type { Tenant, CreateTenantRequest, UpdateTenantRequest, CreateTenantWithShopRequest, TenantWithShopAndApiKey, PaginatedResponse, PaginationQuery, User, CreateUserRequest, Shop, CreateShopRequest, UpdateShopRequest, Role, UserRoleResponse, CreateUserRoleRequest, GetUserRolesQuery, UserShop, CreateUserShopRequest, GetUserShopsQuery, ApiKey, CreateApiKeyRequest } from '@sales-planner/shared';
+interface GetTenantsQuery extends PaginationQuery {
+    owner_id?: number;
+}
+export declare function useTenants(query?: GetTenantsQuery, options?: Omit<UseQueryOptions<PaginatedResponse<Tenant>>, 'queryKey' | 'queryFn'>): import("@tanstack/react-query").UseQueryResult<PaginatedResponse<Tenant>, Error>;
+export declare function useTenantById(id: number, options?: Omit<UseQueryOptions<Tenant>, 'queryKey' | 'queryFn'>): import("@tanstack/react-query").UseQueryResult<Tenant, Error>;
+export declare function useCreateTenant(options?: Omit<UseMutationOptions<Tenant, Error, CreateTenantRequest>, 'mutationFn'>): import("@tanstack/react-query").UseMutationResult<Tenant, Error, CreateTenantRequest, unknown>;
+export declare function useCreateTenantWithShopAndUser(options?: Omit<UseMutationOptions<TenantWithShopAndApiKey, Error, CreateTenantWithShopRequest>, 'mutationFn'>): import("@tanstack/react-query").UseMutationResult<TenantWithShopAndApiKey, Error, import("@sales-planner/shared").CreateTenantWithShopDto, unknown>;
+export declare function useUpdateTenant(options?: Omit<UseMutationOptions<Tenant, Error, {
+    id: number;
+    data: UpdateTenantRequest;
+}>, 'mutationFn'>): import("@tanstack/react-query").UseMutationResult<Tenant, Error, {
+    id: number;
+    data: UpdateTenantRequest;
+}, unknown>;
+export declare function useDeleteTenant(options?: Omit<UseMutationOptions<void, Error, number>, 'mutationFn'>): import("@tanstack/react-query").UseMutationResult<void, Error, number, unknown>;
+interface GetUsersQuery extends PaginationQuery {
+    tenantId?: number;
+}
+export declare function useUsers(query?: GetUsersQuery, options?: Omit<UseQueryOptions<PaginatedResponse<User>>, 'queryKey' | 'queryFn'>): import("@tanstack/react-query").UseQueryResult<PaginatedResponse<User>, Error>;
+export declare function useUserById(id: number, options?: Omit<UseQueryOptions<User>, 'queryKey' | 'queryFn'>): import("@tanstack/react-query").UseQueryResult<User, Error>;
+export declare function useCreateUser(options?: Omit<UseMutationOptions<User, Error, CreateUserRequest>, 'mutationFn'>): import("@tanstack/react-query").UseMutationResult<User, Error, import("@sales-planner/shared").CreateUserDto, unknown>;
+export declare function useDeleteUser(options?: Omit<UseMutationOptions<void, Error, number>, 'mutationFn'>): import("@tanstack/react-query").UseMutationResult<void, Error, number, unknown>;
+interface GetShopsQuery extends PaginationQuery {
+    tenantId?: number;
+}
+export declare function useShops(query?: GetShopsQuery, options?: Omit<UseQueryOptions<PaginatedResponse<Shop>>, 'queryKey' | 'queryFn'>): import("@tanstack/react-query").UseQueryResult<PaginatedResponse<Shop>, Error>;
+export declare function useShopById(id: number, options?: Omit<UseQueryOptions<Shop>, 'queryKey' | 'queryFn'>): import("@tanstack/react-query").UseQueryResult<Shop, Error>;
+export declare function useCreateShop(options?: Omit<UseMutationOptions<Shop, Error, CreateShopRequest>, 'mutationFn'>): import("@tanstack/react-query").UseMutationResult<Shop, Error, import("@sales-planner/shared").CreateShopDto, unknown>;
+export declare function useUpdateShop(options?: Omit<UseMutationOptions<Shop, Error, {
+    id: number;
+    data: UpdateShopRequest;
+}>, 'mutationFn'>): import("@tanstack/react-query").UseMutationResult<Shop, Error, {
+    id: number;
+    data: UpdateShopRequest;
+}, unknown>;
+export declare function useRoles(query?: PaginationQuery, options?: Omit<UseQueryOptions<PaginatedResponse<Role>>, 'queryKey' | 'queryFn'>): import("@tanstack/react-query").UseQueryResult<PaginatedResponse<Role>, Error>;
+export declare function useRoleById(id: number, options?: Omit<UseQueryOptions<Role>, 'queryKey' | 'queryFn'>): import("@tanstack/react-query").UseQueryResult<Role, Error>;
+interface GetUserRolesQueryWithPagination extends GetUserRolesQuery, PaginationQuery {
+}
+export declare function useUserRoles(query?: GetUserRolesQueryWithPagination, options?: Omit<UseQueryOptions<PaginatedResponse<UserRoleResponse>>, 'queryKey' | 'queryFn'>): import("@tanstack/react-query").UseQueryResult<PaginatedResponse<UserRoleResponse>, Error>;
+export declare function useUserRoleById(id: number, options?: Omit<UseQueryOptions<UserRoleResponse>, 'queryKey' | 'queryFn'>): import("@tanstack/react-query").UseQueryResult<UserRoleResponse, Error>;
+export declare function useCreateUserRole(options?: Omit<UseMutationOptions<UserRoleResponse, Error, CreateUserRoleRequest>, 'mutationFn'>): import("@tanstack/react-query").UseMutationResult<UserRoleResponse, Error, import("@sales-planner/shared").CreateUserRoleDto, unknown>;
+export declare function useDeleteUserRole(options?: Omit<UseMutationOptions<void, Error, number>, 'mutationFn'>): import("@tanstack/react-query").UseMutationResult<void, Error, number, unknown>;
+export declare function useUserShops(query?: GetUserShopsQuery, options?: Omit<UseQueryOptions<UserShop[]>, 'queryKey' | 'queryFn'>): import("@tanstack/react-query").UseQueryResult<UserShop[], Error>;
+export declare function useUserShopById(id: number, options?: Omit<UseQueryOptions<UserShop>, 'queryKey' | 'queryFn'>): import("@tanstack/react-query").UseQueryResult<UserShop, Error>;
+export declare function useCreateUserShop(options?: Omit<UseMutationOptions<UserShop, Error, CreateUserShopRequest>, 'mutationFn'>): import("@tanstack/react-query").UseMutationResult<UserShop, Error, import("@sales-planner/shared").CreateUserShopDto, unknown>;
+export declare function useDeleteUserShop(options?: Omit<UseMutationOptions<void, Error, number>, 'mutationFn'>): import("@tanstack/react-query").UseMutationResult<void, Error, number, unknown>;
+interface GetApiKeysQuery extends PaginationQuery {
+    user_id?: number;
+}
+export declare function useApiKeys(query?: GetApiKeysQuery, options?: Omit<UseQueryOptions<PaginatedResponse<ApiKey>>, 'queryKey' | 'queryFn'>): import("@tanstack/react-query").UseQueryResult<PaginatedResponse<ApiKey>, Error>;
+export declare function useCreateApiKey(options?: Omit<UseMutationOptions<ApiKey, Error, CreateApiKeyRequest>, 'mutationFn'>): import("@tanstack/react-query").UseMutationResult<ApiKey, Error, import("@sales-planner/shared").CreateApiKeyDto, unknown>;
+export declare function useRevokeApiKey(options?: Omit<UseMutationOptions<void, Error, number>, 'mutationFn'>): import("@tanstack/react-query").UseMutationResult<void, Error, number, unknown>;
+export {};
+//# sourceMappingURL=admin.d.ts.map

package/dist/admin.d.ts.map

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

package/dist/admin.js

@@ -0,0 +1,266 @@
+import { useQuery, useMutation, useQueryClient } from '@tanstack/react-query';
+import { useSalesPlannerClient } from './provider.js';
+import { queryKeys } from './keys.js';
+export function useTenants(query, options) {
+    const client = useSalesPlannerClient();
+    return useQuery({
+        queryKey: queryKeys.tenants(query),
+        queryFn: () => client.tenants.getAll(query),
+        ...options,
+    });
+}
+export function useTenantById(id, options) {
+    const client = useSalesPlannerClient();
+    return useQuery({
+        queryKey: queryKeys.tenantDetail(id),
+        queryFn: () => client.tenants.getById(id),
+        ...options,
+    });
+}
+export function useCreateTenant(options) {
+    const client = useSalesPlannerClient();
+    const qc = useQueryClient();
+    return useMutation({
+        mutationFn: (request) => client.tenants.create(request),
+        onSuccess: () => {
+            qc.invalidateQueries({ queryKey: ['sales-planner', 'tenants'] });
+        },
+        ...options,
+    });
+}
+export function useCreateTenantWithShopAndUser(options) {
+    const client = useSalesPlannerClient();
+    const qc = useQueryClient();
+    return useMutation({
+        mutationFn: (request) => client.tenants.createWithShopAndUser(request),
+        onSuccess: () => {
+            qc.invalidateQueries({ queryKey: ['sales-planner', 'tenants'] });
+            qc.invalidateQueries({ queryKey: ['sales-planner', 'shops'] });
+            qc.invalidateQueries({ queryKey: ['sales-planner', 'users'] });
+            qc.invalidateQueries({ queryKey: ['sales-planner', 'api-keys'] });
+        },
+        ...options,
+    });
+}
+export function useUpdateTenant(options) {
+    const client = useSalesPlannerClient();
+    const qc = useQueryClient();
+    return useMutation({
+        mutationFn: ({ id, data }) => client.tenants.update(id, data),
+        onSuccess: () => {
+            qc.invalidateQueries({ queryKey: ['sales-planner', 'tenants'] });
+        },
+        ...options,
+    });
+}
+export function useDeleteTenant(options) {
+    const client = useSalesPlannerClient();
+    const qc = useQueryClient();
+    return useMutation({
+        mutationFn: (id) => client.tenants.delete(id),
+        onSuccess: () => {
+            qc.invalidateQueries({ queryKey: ['sales-planner', 'tenants'] });
+        },
+        ...options,
+    });
+}
+export function useUsers(query, options) {
+    const client = useSalesPlannerClient();
+    return useQuery({
+        queryKey: queryKeys.users(query),
+        queryFn: () => client.users.getAll(query),
+        ...options,
+    });
+}
+export function useUserById(id, options) {
+    const client = useSalesPlannerClient();
+    return useQuery({
+        queryKey: queryKeys.userDetail(id),
+        queryFn: () => client.users.getById(id),
+        ...options,
+    });
+}
+export function useCreateUser(options) {
+    const client = useSalesPlannerClient();
+    const qc = useQueryClient();
+    return useMutation({
+        mutationFn: (request) => client.users.create(request),
+        onSuccess: () => {
+            qc.invalidateQueries({ queryKey: ['sales-planner', 'users'] });
+        },
+        ...options,
+    });
+}
+export function useDeleteUser(options) {
+    const client = useSalesPlannerClient();
+    const qc = useQueryClient();
+    return useMutation({
+        mutationFn: (id) => client.users.delete(id),
+        onSuccess: () => {
+            qc.invalidateQueries({ queryKey: ['sales-planner', 'users'] });
+        },
+        ...options,
+    });
+}
+export function useShops(query, options) {
+    const client = useSalesPlannerClient();
+    return useQuery({
+        queryKey: queryKeys.shops(query),
+        queryFn: () => client.shops.getAll(query),
+        ...options,
+    });
+}
+export function useShopById(id, options) {
+    const client = useSalesPlannerClient();
+    return useQuery({
+        queryKey: queryKeys.shopDetail(id),
+        queryFn: () => client.shops.getById(id),
+        ...options,
+    });
+}
+export function useCreateShop(options) {
+    const client = useSalesPlannerClient();
+    const qc = useQueryClient();
+    return useMutation({
+        mutationFn: (request) => client.shops.create(request),
+        onSuccess: () => {
+            qc.invalidateQueries({ queryKey: ['sales-planner', 'shops'] });
+        },
+        ...options,
+    });
+}
+export function useUpdateShop(options) {
+    const client = useSalesPlannerClient();
+    const qc = useQueryClient();
+    return useMutation({
+        mutationFn: ({ id, data }) => client.shops.update(id, data),
+        onSuccess: () => {
+            qc.invalidateQueries({ queryKey: ['sales-planner', 'shops'] });
+        },
+        ...options,
+    });
+}
+// ── Roles ──
+export function useRoles(query, options) {
+    const client = useSalesPlannerClient();
+    return useQuery({
+        queryKey: queryKeys.roles(query),
+        queryFn: () => client.roles.getAll(query),
+        ...options,
+    });
+}
+export function useRoleById(id, options) {
+    const client = useSalesPlannerClient();
+    return useQuery({
+        queryKey: queryKeys.roleDetail(id),
+        queryFn: () => client.roles.getById(id),
+        ...options,
+    });
+}
+export function useUserRoles(query, options) {
+    const client = useSalesPlannerClient();
+    return useQuery({
+        queryKey: queryKeys.userRoles(query),
+        queryFn: () => client.userRoles.getAll(query),
+        ...options,
+    });
+}
+export function useUserRoleById(id, options) {
+    const client = useSalesPlannerClient();
+    return useQuery({
+        queryKey: queryKeys.userRoleDetail(id),
+        queryFn: () => client.userRoles.getById(id),
+        ...options,
+    });
+}
+export function useCreateUserRole(options) {
+    const client = useSalesPlannerClient();
+    const qc = useQueryClient();
+    return useMutation({
+        mutationFn: (request) => client.userRoles.create(request),
+        onSuccess: () => {
+            qc.invalidateQueries({ queryKey: ['sales-planner', 'user-roles'] });
+        },
+        ...options,
+    });
+}
+export function useDeleteUserRole(options) {
+    const client = useSalesPlannerClient();
+    const qc = useQueryClient();
+    return useMutation({
+        mutationFn: (id) => client.userRoles.delete(id),
+        onSuccess: () => {
+            qc.invalidateQueries({ queryKey: ['sales-planner', 'user-roles'] });
+        },
+        ...options,
+    });
+}
+// ── User Shops ──
+export function useUserShops(query, options) {
+    const client = useSalesPlannerClient();
+    return useQuery({
+        queryKey: queryKeys.userShops(query),
+        queryFn: () => client.userShops.getAll(query),
+        ...options,
+    });
+}
+export function useUserShopById(id, options) {
+    const client = useSalesPlannerClient();
+    return useQuery({
+        queryKey: queryKeys.userShopDetail(id),
+        queryFn: () => client.userShops.getById(id),
+        ...options,
+    });
+}
+export function useCreateUserShop(options) {
+    const client = useSalesPlannerClient();
+    const qc = useQueryClient();
+    return useMutation({
+        mutationFn: (request) => client.userShops.create(request),
+        onSuccess: () => {
+            qc.invalidateQueries({ queryKey: ['sales-planner', 'user-shops'] });
+        },
+        ...options,
+    });
+}
+export function useDeleteUserShop(options) {
+    const client = useSalesPlannerClient();
+    const qc = useQueryClient();
+    return useMutation({
+        mutationFn: (id) => client.userShops.delete(id),
+        onSuccess: () => {
+            qc.invalidateQueries({ queryKey: ['sales-planner', 'user-shops'] });
+        },
+        ...options,
+    });
+}
+export function useApiKeys(query, options) {
+    const client = useSalesPlannerClient();
+    return useQuery({
+        queryKey: queryKeys.apiKeys(query),
+        queryFn: () => client.apiKeys.getAll(query),
+        ...options,
+    });
+}
+export function useCreateApiKey(options) {
+    const client = useSalesPlannerClient();
+    const qc = useQueryClient();
+    return useMutation({
+        mutationFn: (request) => client.apiKeys.create(request),
+        onSuccess: () => {
+            qc.invalidateQueries({ queryKey: ['sales-planner', 'api-keys'] });
+        },
+        ...options,
+    });
+}
+export function useRevokeApiKey(options) {
+    const client = useSalesPlannerClient();
+    const qc = useQueryClient();
+    return useMutation({
+        mutationFn: (id) => client.apiKeys.delete(id),
+        onSuccess: () => {
+            qc.invalidateQueries({ queryKey: ['sales-planner', 'api-keys'] });
+        },
+        ...options,
+    });
+}

package/dist/coded-entities.d.ts

@@ -5,6 +5,8 @@ export declare const brands: {
     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>;
+    useExampleJson: (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>;
+    useExampleCsv: (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;
@@ -23,6 +25,8 @@ export declare const categories: {
     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>;
+    useExampleJson: (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>;
+    useExampleCsv: (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;
@@ -41,6 +45,8 @@ export declare const groups: {
     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>;
+    useExampleJson: (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>;
+    useExampleCsv: (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;
@@ -59,6 +65,8 @@ export declare const statuses: {
     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>;
+    useExampleJson: (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>;
+    useExampleCsv: (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;
@@ -77,6 +85,8 @@ export declare const suppliers: {
     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>;
+    useExampleJson: (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>;
+    useExampleCsv: (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;
@@ -95,6 +105,8 @@ export declare const warehouses: {
     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>;
+    useExampleJson: (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>;
+    useExampleCsv: (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;
@@ -113,6 +125,8 @@ export declare const marketplaces: {
     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>;
+    useExampleJson: (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>;
+    useExampleCsv: (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;

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

@@ -1 +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"}
+{"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/create-coded-entity-hooks.d.ts

@@ -13,6 +13,8 @@ type CodedEntityClientLike<TEntity, TCreate, TUpdate, TImport, TExport> = {
     importCsv(ctx: ShopContextParams, csvContent: string): Promise<ImportResult>;
     exportJson(ctx: ShopContextParams): Promise<TExport[]>;
     exportCsv(ctx: ShopContextParams): Promise<string>;
+    getExampleJson(): Promise<TImport[]>;
+    getExampleCsv(): Promise<string>;
 };
 /**
  * Creates a set of React Query hooks for a coded entity (brands, categories, etc.)
@@ -23,6 +25,8 @@ export declare function createCodedEntityHooks<TEntity, TCreate, TUpdate, TImpor
     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>;
+    useExampleJson: (options?: Omit<UseQueryOptions<TImport[]>, "queryKey" | "queryFn">) => import("@tanstack/react-query").UseQueryResult<TImport[], Error>;
+    useExampleCsv: (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;

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

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

@@ -102,12 +102,32 @@ export function createCodedEntityHooks(entityName, getClient) {
             ...options,
         });
     }
+    function useExampleJson(options) {
+        const client = useSalesPlannerClient();
+        return useQuery({
+            queryKey: queryKeys.entityExample(entityName, 'json'),
+            queryFn: () => getClient(client).getExampleJson(),
+            staleTime: Number.POSITIVE_INFINITY,
+            ...options,
+        });
+    }
+    function useExampleCsv(options) {
+        const client = useSalesPlannerClient();
+        return useQuery({
+            queryKey: queryKeys.entityExample(entityName, 'csv'),
+            queryFn: () => getClient(client).getExampleCsv(),
+            staleTime: Number.POSITIVE_INFINITY,
+            ...options,
+        });
+    }
     return {
         useList,
         useById,
         useByCode,
         useExportJson,
         useExportCsv,
+        useExampleJson,
+        useExampleCsv,
         useCreate,
         useUpdate,
         useDelete,

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

@@ -12,6 +12,8 @@ type ShopScopedClientLike<TEntity, TCreate, TUpdate, TImport, TExport, TImportRe
     importCsv(ctx: ShopContextParams, csvContent: string): Promise<TImportResult>;
     exportJson(ctx: ShopContextParams, query?: TQuery): Promise<TExport[]>;
     exportCsv(ctx: ShopContextParams, query?: TQuery): Promise<string>;
+    getExampleJson(): Promise<TImport[]>;
+    getExampleCsv(): Promise<string>;
 };
 /**
  * Creates a set of React Query hooks for a shop-scoped entity
@@ -22,6 +24,8 @@ export declare function createShopScopedHooks<TEntity, TCreate, TUpdate, TImport
     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>;
+    useExampleJson: (options?: Omit<UseQueryOptions<TImport[]>, "queryKey" | "queryFn">) => import("@tanstack/react-query").UseQueryResult<TImport[], Error>;
+    useExampleCsv: (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;

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

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

@@ -95,11 +95,31 @@ export function createShopScopedHooks(entityName, getClient) {
             ...options,
         });
     }
+    function useExampleJson(options) {
+        const client = useSalesPlannerClient();
+        return useQuery({
+            queryKey: queryKeys.entityExample(entityName, 'json'),
+            queryFn: () => getClient(client).getExampleJson(),
+            staleTime: Number.POSITIVE_INFINITY,
+            ...options,
+        });
+    }
+    function useExampleCsv(options) {
+        const client = useSalesPlannerClient();
+        return useQuery({
+            queryKey: queryKeys.entityExample(entityName, 'csv'),
+            queryFn: () => getClient(client).getExampleCsv(),
+            staleTime: Number.POSITIVE_INFINITY,
+            ...options,
+        });
+    }
     return {
         useList,
         useById,
         useExportJson,
         useExportCsv,
+        useExampleJson,
+        useExampleCsv,
         useCreate,
         useUpdate,
         useDelete,

package/dist/index.d.ts

@@ -19,4 +19,5 @@ 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';
+export { useTenants, useTenantById, useCreateTenant, useCreateTenantWithShopAndUser, useUpdateTenant, useDeleteTenant, useUsers, useUserById, useCreateUser, useDeleteUser, useShops, useShopById, useCreateShop, useUpdateShop, useRoles, useRoleById, useUserRoles, useUserRoleById, useCreateUserRole, useDeleteUserRole, useUserShops, useUserShopById, useCreateUserShop, useDeleteUserShop, useApiKeys, useCreateApiKey, useRevokeApiKey, } from './admin.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}
+{"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;AAG1B,OAAO,EAEL,UAAU,EACV,aAAa,EACb,eAAe,EACf,8BAA8B,EAC9B,eAAe,EACf,eAAe,EAEf,QAAQ,EACR,WAAW,EACX,aAAa,EACb,aAAa,EAEb,QAAQ,EACR,WAAW,EACX,aAAa,EACb,aAAa,EAEb,QAAQ,EACR,WAAW,EAEX,YAAY,EACZ,eAAe,EACf,iBAAiB,EACjB,iBAAiB,EAEjB,YAAY,EACZ,eAAe,EACf,iBAAiB,EACjB,iBAAiB,EAEjB,UAAU,EACV,eAAe,EACf,eAAe,GAChB,MAAM,YAAY,CAAC"}

package/dist/index.js

@@ -23,3 +23,19 @@ 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';
+// ── Admin hooks ──
+export { 
+// Tenants
+useTenants, useTenantById, useCreateTenant, useCreateTenantWithShopAndUser, useUpdateTenant, useDeleteTenant, 
+// Users
+useUsers, useUserById, useCreateUser, useDeleteUser, 
+// Shops
+useShops, useShopById, useCreateShop, useUpdateShop, 
+// Roles
+useRoles, useRoleById, 
+// User Roles
+useUserRoles, useUserRoleById, useCreateUserRole, useDeleteUserRole, 
+// User Shops
+useUserShops, useUserShopById, useCreateUserShop, useDeleteUserShop, 
+// API Keys
+useApiKeys, useCreateApiKey, useRevokeApiKey, } from './admin.js';

package/dist/keys.d.ts

@@ -13,11 +13,26 @@ export declare function toShopContextParams(ctx: ShopContext): ShopContextParams
 export declare const queryKeys: {
     readonly me: () => readonly ["sales-planner", "me"];
     readonly metadata: () => readonly ["sales-planner", "metadata"];
+    readonly tenants: (query?: Record<string, unknown>) => readonly ["sales-planner", "tenants", Record<string, unknown>];
+    readonly tenantDetail: (id: number) => readonly ["sales-planner", "tenants", number];
+    readonly users: (query?: Record<string, unknown>) => readonly ["sales-planner", "users", Record<string, unknown>];
+    readonly userDetail: (id: number) => readonly ["sales-planner", "users", number];
+    readonly shops: (query?: Record<string, unknown>) => readonly ["sales-planner", "shops", Record<string, unknown>];
+    readonly shopDetail: (id: number) => readonly ["sales-planner", "shops", number];
+    readonly roles: (query?: Record<string, unknown>) => readonly ["sales-planner", "roles", Record<string, unknown>];
+    readonly roleDetail: (id: number) => readonly ["sales-planner", "roles", number];
+    readonly userRoles: (query?: Record<string, unknown>) => readonly ["sales-planner", "user-roles", Record<string, unknown>];
+    readonly userRoleDetail: (id: number) => readonly ["sales-planner", "user-roles", number];
+    readonly userShops: (query?: Record<string, unknown>) => readonly ["sales-planner", "user-shops", Record<string, unknown>];
+    readonly userShopDetail: (id: number) => readonly ["sales-planner", "user-shops", number];
+    readonly apiKeys: (query?: Record<string, unknown>) => readonly ["sales-planner", "api-keys", Record<string, unknown>];
+    readonly apiKeyDetail: (id: number) => readonly ["sales-planner", "api-keys", number];
     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 entityExample: (entity: string, format: "json" | "csv") => readonly ["sales-planner", string, "example", "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];

package/dist/keys.d.ts.map

@@ -1 +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"}
+{"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;;;+BAKF,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;gCACtB,MAAM;6BAET,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;8BACtB,MAAM;6BAEP,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;8BACtB,MAAM;6BAEP,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;8BACtB,MAAM;iCAEH,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;kCAEtB,MAAM;iCAEP,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;kCAEtB,MAAM;+BAET,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;gCACtB,MAAM;8BAGR,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;qCAG/C,MAAM,UAAU,MAAM,GAAG,KAAK;+BAGpC,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

@@ -7,11 +7,28 @@ export function toShopContextParams(ctx) {
 export const queryKeys = {
     me: () => ['sales-planner', 'me'],
     metadata: () => ['sales-planner', 'metadata'],
+    // ── Admin resources (no shop context) ──
+    tenants: (query) => ['sales-planner', 'tenants', query ?? {}],
+    tenantDetail: (id) => ['sales-planner', 'tenants', id],
+    users: (query) => ['sales-planner', 'users', query ?? {}],
+    userDetail: (id) => ['sales-planner', 'users', id],
+    shops: (query) => ['sales-planner', 'shops', query ?? {}],
+    shopDetail: (id) => ['sales-planner', 'shops', id],
+    roles: (query) => ['sales-planner', 'roles', query ?? {}],
+    roleDetail: (id) => ['sales-planner', 'roles', id],
+    userRoles: (query) => ['sales-planner', 'user-roles', query ?? {}],
+    userRoleDetail: (id) => ['sales-planner', 'user-roles', id],
+    userShops: (query) => ['sales-planner', 'user-shops', query ?? {}],
+    userShopDetail: (id) => ['sales-planner', 'user-shops', id],
+    apiKeys: (query) => ['sales-planner', 'api-keys', query ?? {}],
+    apiKeyDetail: (id) => ['sales-planner', 'api-keys', id],
+    // ── Data entities (shop-scoped) ──
     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],
+    entityExample: (entity, format) => ['sales-planner', entity, 'example', 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],

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

@@ -5,6 +5,8 @@ export declare const skus: {
     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>;
+    useExampleJson: (options?: Omit<import("@tanstack/react-query").UseQueryOptions<ImportSkuItem[], Error, ImportSkuItem[], readonly unknown[]>, "queryKey" | "queryFn"> | undefined) => import("@tanstack/react-query").UseQueryResult<ImportSkuItem[], Error>;
+    useExampleCsv: (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;
@@ -22,6 +24,8 @@ export declare const salesHistory: {
     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>;
+    useExampleJson: (options?: Omit<import("@tanstack/react-query").UseQueryOptions<ImportSalesHistoryItem[], Error, ImportSalesHistoryItem[], readonly unknown[]>, "queryKey" | "queryFn"> | undefined) => import("@tanstack/react-query").UseQueryResult<ImportSalesHistoryItem[], Error>;
+    useExampleCsv: (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;
@@ -39,6 +43,8 @@ export declare const leftovers: {
     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>;
+    useExampleJson: (options?: Omit<import("@tanstack/react-query").UseQueryOptions<ImportLeftoverItem[], Error, ImportLeftoverItem[], readonly unknown[]>, "queryKey" | "queryFn"> | undefined) => import("@tanstack/react-query").UseQueryResult<ImportLeftoverItem[], Error>;
+    useExampleCsv: (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;
@@ -56,6 +62,8 @@ export declare const seasonalCoefficients: {
     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>;
+    useExampleJson: (options?: Omit<import("@tanstack/react-query").UseQueryOptions<ImportSeasonalCoefficientItem[], Error, ImportSeasonalCoefficientItem[], readonly unknown[]>, "queryKey" | "queryFn"> | undefined) => import("@tanstack/react-query").UseQueryResult<ImportSeasonalCoefficientItem[], Error>;
+    useExampleCsv: (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;
@@ -73,6 +81,8 @@ export declare const skuCompetitorMappings: {
     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>;
+    useExampleJson: (options?: Omit<import("@tanstack/react-query").UseQueryOptions<ImportSkuCompetitorMappingItem[], Error, ImportSkuCompetitorMappingItem[], readonly unknown[]>, "queryKey" | "queryFn"> | undefined) => import("@tanstack/react-query").UseQueryResult<ImportSkuCompetitorMappingItem[], Error>;
+    useExampleCsv: (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;
@@ -90,6 +100,8 @@ export declare const competitorProducts: {
     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>;
+    useExampleJson: (options?: Omit<import("@tanstack/react-query").UseQueryOptions<ImportCompetitorProductItem[], Error, ImportCompetitorProductItem[], readonly unknown[]>, "queryKey" | "queryFn"> | undefined) => import("@tanstack/react-query").UseQueryResult<ImportCompetitorProductItem[], Error>;
+    useExampleCsv: (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;
@@ -107,6 +119,8 @@ export declare const competitorSales: {
     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>;
+    useExampleJson: (options?: Omit<import("@tanstack/react-query").UseQueryOptions<ImportCompetitorSaleItem[], Error, ImportCompetitorSaleItem[], readonly unknown[]>, "queryKey" | "queryFn"> | undefined) => import("@tanstack/react-query").UseQueryResult<ImportCompetitorSaleItem[], Error>;
+    useExampleCsv: (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;

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

@@ -1 +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"}
+{"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/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@sales-planner/react",
-  "version": "0.2.0",
+  "version": "0.2.2",
   "description": "React hooks for Sales Planner API powered by TanStack Query",
   "author": "Damir Manapov",
   "license": "MIT",
@@ -25,8 +25,8 @@
     "README.md"
   ],
   "dependencies": {
-    "@sales-planner/http-client": "0.19.2",
-    "@sales-planner/shared": "0.17.2"
+    "@sales-planner/http-client": "0.19.3",
+    "@sales-planner/shared": "0.17.3"
   },
   "peerDependencies": {
     "@tanstack/react-query": ">=5.0.0",