@sales-planner/http-client 0.17.3 → 0.19.0

package/README.md

@@ -49,8 +49,17 @@ interface PaginatedResponse<T> {
 Query parameters:
 - `limit` - Number of items per page (1-1000, default: 100)
 - `offset` - Number of items to skip (default: 0)
+- `ids` - Filter by specific IDs (array of numbers)
 
-Sales history, leftovers, and competitor sales also support period filtering:
+**ID Filtering** - All entities support filtering by IDs:
+```typescript
+// Filter any entity by specific IDs
+const { items: brands } = await client.brands.getAll(ctx, { ids: [1, 2, 3] });
+const { items: skus } = await client.skus.getAll(ctx, { ids: [10, 20, 30] });
+const { items: salesHistory } = await client.salesHistory.getAll(ctx, { ids: [100, 101] });
+```
+
+**Period Filtering** - Sales history, leftovers, and competitor sales also support period filtering:
 ```typescript
 const { items, total } = await client.salesHistory.getAll(ctx, {
   period_from: '2024-01',
@@ -66,10 +75,14 @@ const { items: leftovers } = await client.leftovers.getAll(ctx, {
 });
 ```
 
-Competitor products support filtering by IDs:
+**Combined Filtering** - Combine IDs with pagination and period filters:
 ```typescript
-const { items } = await client.competitorProducts.getAll(ctx, {
-  ids: [1, 2, 3],  // Filter by specific IDs
+// Get specific sales history records with period filter
+const { items } = await client.salesHistory.getAll(ctx, {
+  ids: [1, 2, 3],
+  period_from: '2024-01',
+  period_to: '2024-06',
+  limit: 50,
 });
 ```
 
@@ -115,6 +128,33 @@ const metadata = await client.metadata.getEntitiesMetadata();
 console.log(metadata); // { entities: [...], version: "..." }
 ```
 
+## Computed Entities (Read-Only)
+
+SKU metrics and materialized view management:
+
+```typescript
+const ctx = { shop_id: 1, tenant_id: 1 };
+
+// SKU Metrics - aggregated metrics from materialized views
+const { items, total } = await client.skuMetrics.list(ctx.shop_id, ctx.tenant_id);
+const metric = await client.skuMetrics.get(id, ctx.shop_id, ctx.tenant_id);
+const topProducts = await client.skuMetrics.getByAbcClass('A', ctx.shop_id, ctx.tenant_id);
+
+// Export
+const csv = await client.skuMetrics.exportCsv(ctx.shop_id, ctx.tenant_id);
+const json = await client.skuMetrics.exportJson(ctx.shop_id, ctx.tenant_id);
+
+// View Management
+const views = await client.computed.getViews(ctx.shop_id, ctx.tenant_id);
+// [{ name: 'mv_sku_metrics', description: 'SKU metrics with ABC classification' }]
+
+const result = await client.computed.refreshAll(ctx.shop_id, ctx.tenant_id);
+// { results: [...], totalDuration: 1234, success: true }
+
+const viewResult = await client.computed.refreshView('mv_sku_metrics', ctx.shop_id, ctx.tenant_id);
+// { view: 'mv_sku_metrics', duration: 500, success: true }
+```
+
 ## Error Handling
 
 ```typescript
@@ -140,6 +180,7 @@ interface ShopContextParams {
 
 // Pagination (all getAll methods support this)
 interface PaginationQuery {
+  ids?: number[];   // Filter by specific IDs
   limit?: number;   // 1-1000, default: 100
   offset?: number;  // default: 0
 }
@@ -326,6 +367,51 @@ Available entity types summary:
 - `Sku`, `Brand`, `Category`, `Group`, `Status`, `Supplier`, `Warehouse`, `Marketplace` - shop data
 - `SalesHistory`, `Leftover`, `SeasonalCoefficient` - time-series data
 - `CompetitorProduct`, `CompetitorSale`, `SkuCompetitorMapping` - competitor data
+- `SkuMetrics` - computed entity (read-only, from materialized view)
+
+#### Computed Entities
+
+```typescript
+interface SkuMetrics {
+  id: number;
+  sku_id: number;
+  shop_id: number;
+  tenant_id: number;
+  sku_code: string;
+  sku_title: string;
+  group_code: string | null;
+  category_code: string | null;
+  brand_code: string | null;
+  status_code: string | null;
+  supplier_code: string | null;
+  last_period: string;        // YYYY-MM format
+  last_period_sales: number;  // Total sales for last period
+  current_stock: number;      // Current inventory
+  days_of_stock: number | null;
+  abc_class: 'A' | 'B' | 'C'; // A=top 20%, B=next 30%, C=bottom 50%
+  sales_rank: number;         // 1 = highest sales
+  computed_at: Date;
+}
+
+// View management types
+interface ViewInfo {
+  name: string;
+  description: string;
+}
+
+interface RefreshResult {
+  view: string;
+  duration: number;
+  success: boolean;
+  error?: string;
+}
+
+interface RefreshAllResult {
+  results: RefreshResult[];
+  totalDuration: number;
+  success: boolean;
+}
+```
 
 ### Import/Export Types
 
@@ -374,6 +460,9 @@ import type {
   // Competitor Entities
   CompetitorProduct, CompetitorSale, SkuCompetitorMapping,
   
+  // Computed Entities (read-only)
+  SkuMetrics,
+  
   // User/Me Response Types
   UserWithRolesAndTenants, UserRole, TenantInfo, ShopInfo,
   

package/dist/clients/computed-entities-client.d.ts

@@ -0,0 +1,44 @@
+import { BaseClient } from './base-client.js';
+/**
+ * View metadata returned by getViews
+ */
+export interface ViewInfo {
+    name: string;
+    description: string;
+}
+/**
+ * Result of refreshing a single view
+ */
+export interface RefreshResult {
+    view: string;
+    duration: number;
+    success: boolean;
+    error?: string;
+}
+/**
+ * Result of refreshing all views
+ */
+export interface RefreshAllResult {
+    results: RefreshResult[];
+    totalDuration: number;
+    success: boolean;
+}
+/**
+ * Client for managing computed entities (materialized views).
+ * Provides view listing and refresh operations.
+ */
+export declare class ComputedEntitiesClient extends BaseClient {
+    /**
+     * Get list of all available materialized views
+     */
+    getViews(shopId: number, tenantId: number): Promise<ViewInfo[]>;
+    /**
+     * Refresh all materialized views in dependency order
+     */
+    refreshAll(shopId: number, tenantId: number): Promise<RefreshAllResult>;
+    /**
+     * Refresh a single materialized view by name
+     */
+    refreshView(viewName: string, shopId: number, tenantId: number): Promise<RefreshResult>;
+}
+//# sourceMappingURL=computed-entities-client.d.ts.map

package/dist/clients/computed-entities-client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"computed-entities-client.d.ts","sourceRoot":"","sources":["../../src/clients/computed-entities-client.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAE9C;;GAEG;AACH,MAAM,WAAW,QAAQ;IACvB,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;CACrB;AAED;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,OAAO,CAAC;IACjB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,OAAO,EAAE,aAAa,EAAE,CAAC;IACzB,aAAa,EAAE,MAAM,CAAC;IACtB,OAAO,EAAE,OAAO,CAAC;CAClB;AAED;;;GAGG;AACH,qBAAa,sBAAuB,SAAQ,UAAU;IACpD;;OAEG;IACG,QAAQ,CAAC,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,QAAQ,EAAE,CAAC;IASrE;;OAEG;IACG,UAAU,CAAC,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,gBAAgB,CAAC;IAS7E;;OAEG;IACG,WAAW,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,CAAC;CAQ9F"}

package/dist/clients/computed-entities-client.js

@@ -0,0 +1,40 @@
+import { BaseClient } from './base-client.js';
+/**
+ * Client for managing computed entities (materialized views).
+ * Provides view listing and refresh operations.
+ */
+export class ComputedEntitiesClient extends BaseClient {
+    /**
+     * Get list of all available materialized views
+     */
+    async getViews(shopId, tenantId) {
+        return this.request('GET', '/computed/views', {
+            params: {
+                shop_id: shopId,
+                tenant_id: tenantId,
+            },
+        });
+    }
+    /**
+     * Refresh all materialized views in dependency order
+     */
+    async refreshAll(shopId, tenantId) {
+        return this.request('POST', '/computed/refresh', {
+            params: {
+                shop_id: shopId,
+                tenant_id: tenantId,
+            },
+        });
+    }
+    /**
+     * Refresh a single materialized view by name
+     */
+    async refreshView(viewName, shopId, tenantId) {
+        return this.request('POST', `/computed/refresh/${viewName}`, {
+            params: {
+                shop_id: shopId,
+                tenant_id: tenantId,
+            },
+        });
+    }
+}

package/dist/clients/index.d.ts

@@ -1,3 +1,5 @@
 export { SalesPlannerClient } from './sales-planner-client.js';
 export { ApiError, type ClientConfig } from './base-client.js';
+export { SkuMetricsClient } from './sku-metrics-client.js';
+export { ComputedEntitiesClient, type ViewInfo, type RefreshResult, type RefreshAllResult, } from './computed-entities-client.js';
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/clients/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,kBAAkB,EAAE,MAAM,2BAA2B,CAAC;AAC/D,OAAO,EAAE,QAAQ,EAAE,KAAK,YAAY,EAAE,MAAM,kBAAkB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/clients/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,kBAAkB,EAAE,MAAM,2BAA2B,CAAC;AAC/D,OAAO,EAAE,QAAQ,EAAE,KAAK,YAAY,EAAE,MAAM,kBAAkB,CAAC;AAC/D,OAAO,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAC3D,OAAO,EACL,sBAAsB,EACtB,KAAK,QAAQ,EACb,KAAK,aAAa,EAClB,KAAK,gBAAgB,GACtB,MAAM,+BAA+B,CAAC"}

package/dist/clients/index.js

@@ -1,2 +1,4 @@
 export { SalesPlannerClient } from './sales-planner-client.js';
 export { ApiError } from './base-client.js';
+export { SkuMetricsClient } from './sku-metrics-client.js';
+export { ComputedEntitiesClient, } from './computed-entities-client.js';

package/dist/clients/sales-planner-client.d.ts

@@ -1,4 +1,4 @@
-import type { Brand, CreateBrandRequest, UpdateBrandRequest, ImportBrandItem, BrandExportItem, Category, CreateCategoryRequest, UpdateCategoryRequest, ImportCategoryItem, CategoryExportItem, CompetitorProduct, CreateCompetitorProductRequest, UpdateCompetitorProductRequest, ImportCompetitorProductItem, CompetitorProductExportItem, CompetitorProductQuery, CompetitorSale, CreateCompetitorSaleRequest, UpdateCompetitorSaleRequest, ImportCompetitorSaleItem, CompetitorSaleExportItem, CompetitorSaleQuery, Group, CreateGroupRequest, UpdateGroupRequest, ImportGroupItem, GroupExportItem, Leftover, CreateLeftoverRequest, UpdateLeftoverRequest, ImportLeftoverItem, LeftoverExportItem, LeftoverQuery, Status, CreateStatusRequest, UpdateStatusRequest, ImportStatusItem, StatusExportItem, Supplier, CreateSupplierRequest, UpdateSupplierRequest, ImportSupplierItem, SupplierExportItem, SeasonalCoefficient, CreateSeasonalCoefficientRequest, UpdateSeasonalCoefficientRequest, ImportSeasonalCoefficientItem, SeasonalCoefficientExportItem, SkuCompetitorMapping, CreateSkuCompetitorMappingRequest, UpdateSkuCompetitorMappingRequest, ImportSkuCompetitorMappingItem, SkuCompetitorMappingExportItem, Warehouse, CreateWarehouseRequest, UpdateWarehouseRequest, ImportWarehouseItem, WarehouseExportItem, Marketplace, CreateMarketplaceRequest, UpdateMarketplaceRequest, ImportMarketplaceItem, MarketplaceExportItem, Role, CreateRoleRequest, UpdateRoleRequest, SalesHistory, CreateSalesHistoryRequest, UpdateSalesHistoryRequest, ImportSalesHistoryItem, SalesHistoryExportItem, SalesHistoryImportResult, SalesHistoryQuery, ImportResult } from '@sales-planner/shared';
+import type { Brand, CreateBrandRequest, UpdateBrandRequest, ImportBrandItem, BrandExportItem, Category, CreateCategoryRequest, UpdateCategoryRequest, ImportCategoryItem, CategoryExportItem, CompetitorProduct, CreateCompetitorProductRequest, UpdateCompetitorProductRequest, ImportCompetitorProductItem, CompetitorProductExportItem, CompetitorProductQuery, CompetitorSale, CreateCompetitorSaleRequest, UpdateCompetitorSaleRequest, ImportCompetitorSaleItem, CompetitorSaleExportItem, CompetitorSaleQuery, Group, CreateGroupRequest, UpdateGroupRequest, ImportGroupItem, GroupExportItem, Leftover, CreateLeftoverRequest, UpdateLeftoverRequest, ImportLeftoverItem, LeftoverExportItem, LeftoverQuery, PaginationQuery, Status, CreateStatusRequest, UpdateStatusRequest, ImportStatusItem, StatusExportItem, Supplier, CreateSupplierRequest, UpdateSupplierRequest, ImportSupplierItem, SupplierExportItem, SeasonalCoefficient, CreateSeasonalCoefficientRequest, UpdateSeasonalCoefficientRequest, ImportSeasonalCoefficientItem, SeasonalCoefficientExportItem, SkuCompetitorMapping, CreateSkuCompetitorMappingRequest, UpdateSkuCompetitorMappingRequest, ImportSkuCompetitorMappingItem, SkuCompetitorMappingExportItem, Warehouse, CreateWarehouseRequest, UpdateWarehouseRequest, ImportWarehouseItem, WarehouseExportItem, Marketplace, CreateMarketplaceRequest, UpdateMarketplaceRequest, ImportMarketplaceItem, MarketplaceExportItem, Role, CreateRoleRequest, UpdateRoleRequest, SalesHistory, CreateSalesHistoryRequest, UpdateSalesHistoryRequest, ImportSalesHistoryItem, SalesHistoryExportItem, SalesHistoryImportResult, SalesHistoryQuery, ImportResult } from '@sales-planner/shared';
 import type { ClientConfig } from './base-client.js';
 import { CodedEntityClient } from './coded-entity-client.js';
 import { CrudClient } from './crud-client.js';
@@ -11,6 +11,8 @@ import { ShopsClient } from './shops-client.js';
 import { SkusClient } from './skus-client.js';
 import { UserRolesClient } from './user-roles-client.js';
 import { ApiKeysClient } from './api-keys-client.js';
+import { SkuMetricsClient } from './sku-metrics-client.js';
+import { ComputedEntitiesClient } from './computed-entities-client.js';
 export declare class SalesPlannerClient {
     private baseUrl;
     readonly me: MeClient;
@@ -28,13 +30,15 @@ export declare class SalesPlannerClient {
     readonly marketplaces: CodedEntityClient<Marketplace, CreateMarketplaceRequest, UpdateMarketplaceRequest, ImportMarketplaceItem, MarketplaceExportItem>;
     readonly salesHistory: ShopScopedClient<SalesHistory, CreateSalesHistoryRequest, UpdateSalesHistoryRequest, ImportSalesHistoryItem, SalesHistoryExportItem, SalesHistoryImportResult, SalesHistoryQuery>;
     readonly leftovers: ShopScopedClient<Leftover, CreateLeftoverRequest, UpdateLeftoverRequest, ImportLeftoverItem, LeftoverExportItem, ImportResult, LeftoverQuery>;
-    readonly seasonalCoefficients: ShopScopedClient<SeasonalCoefficient, CreateSeasonalCoefficientRequest, UpdateSeasonalCoefficientRequest, ImportSeasonalCoefficientItem, SeasonalCoefficientExportItem, ImportResult, Record<string, never>>;
-    readonly skuCompetitorMappings: ShopScopedClient<SkuCompetitorMapping, CreateSkuCompetitorMappingRequest, UpdateSkuCompetitorMappingRequest, ImportSkuCompetitorMappingItem, SkuCompetitorMappingExportItem, ImportResult, Record<string, never>>;
+    readonly seasonalCoefficients: ShopScopedClient<SeasonalCoefficient, CreateSeasonalCoefficientRequest, UpdateSeasonalCoefficientRequest, ImportSeasonalCoefficientItem, SeasonalCoefficientExportItem, ImportResult, PaginationQuery>;
+    readonly skuCompetitorMappings: ShopScopedClient<SkuCompetitorMapping, CreateSkuCompetitorMappingRequest, UpdateSkuCompetitorMappingRequest, ImportSkuCompetitorMappingItem, SkuCompetitorMappingExportItem, ImportResult, PaginationQuery>;
     readonly competitorProducts: ShopScopedClient<CompetitorProduct, CreateCompetitorProductRequest, UpdateCompetitorProductRequest, ImportCompetitorProductItem, CompetitorProductExportItem, ImportResult, CompetitorProductQuery>;
     readonly competitorSales: ShopScopedClient<CompetitorSale, CreateCompetitorSaleRequest, UpdateCompetitorSaleRequest, ImportCompetitorSaleItem, CompetitorSaleExportItem, ImportResult, CompetitorSaleQuery>;
     readonly roles: CrudClient<Role, CreateRoleRequest, UpdateRoleRequest>;
     readonly userRoles: UserRolesClient;
     readonly apiKeys: ApiKeysClient;
+    readonly skuMetrics: SkuMetricsClient;
+    readonly computed: ComputedEntitiesClient;
     constructor(config: ClientConfig);
     getRoot(): Promise<string>;
     getHealth(): Promise<{

package/dist/clients/sales-planner-client.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"sales-planner-client.d.ts","sourceRoot":"","sources":["../../src/clients/sales-planner-client.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,KAAK,EACL,kBAAkB,EAClB,kBAAkB,EAClB,eAAe,EACf,eAAe,EACf,QAAQ,EACR,qBAAqB,EACrB,qBAAqB,EACrB,kBAAkB,EAClB,kBAAkB,EAClB,iBAAiB,EACjB,8BAA8B,EAC9B,8BAA8B,EAC9B,2BAA2B,EAC3B,2BAA2B,EAC3B,sBAAsB,EACtB,cAAc,EACd,2BAA2B,EAC3B,2BAA2B,EAC3B,wBAAwB,EACxB,wBAAwB,EACxB,mBAAmB,EACnB,KAAK,EACL,kBAAkB,EAClB,kBAAkB,EAClB,eAAe,EACf,eAAe,EACf,QAAQ,EACR,qBAAqB,EACrB,qBAAqB,EACrB,kBAAkB,EAClB,kBAAkB,EAClB,aAAa,EACb,MAAM,EACN,mBAAmB,EACnB,mBAAmB,EACnB,gBAAgB,EAChB,gBAAgB,EAChB,QAAQ,EACR,qBAAqB,EACrB,qBAAqB,EACrB,kBAAkB,EAClB,kBAAkB,EAClB,mBAAmB,EACnB,gCAAgC,EAChC,gCAAgC,EAChC,6BAA6B,EAC7B,6BAA6B,EAC7B,oBAAoB,EACpB,iCAAiC,EACjC,iCAAiC,EACjC,8BAA8B,EAC9B,8BAA8B,EAC9B,SAAS,EACT,sBAAsB,EACtB,sBAAsB,EACtB,mBAAmB,EACnB,mBAAmB,EACnB,WAAW,EACX,wBAAwB,EACxB,wBAAwB,EACxB,qBAAqB,EACrB,qBAAqB,EACrB,IAAI,EACJ,iBAAiB,EACjB,iBAAiB,EACjB,YAAY,EACZ,yBAAyB,EACzB,yBAAyB,EACzB,sBAAsB,EACtB,sBAAsB,EACtB,wBAAwB,EACxB,iBAAiB,EACjB,YAAY,EACb,MAAM,uBAAuB,CAAC;AAC/B,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AAErD,OAAO,EAAE,iBAAiB,EAAE,MAAM,0BAA0B,CAAC;AAC7D,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAC9C,OAAO,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAC3D,OAAO,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAC1C,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AACtD,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAChD,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AACpD,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAChD,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAC9C,OAAO,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AACzD,OAAO,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AAErD,qBAAa,kBAAkB;IAC7B,OAAO,CAAC,OAAO,CAAS;IAGxB,QAAQ,CAAC,EAAE,EAAE,QAAQ,CAAC;IACtB,QAAQ,CAAC,QAAQ,EAAE,cAAc,CAAC;IAClC,QAAQ,CAAC,KAAK,EAAE,WAAW,CAAC;IAC5B,QAAQ,CAAC,OAAO,EAAE,aAAa,CAAC;IAChC,QAAQ,CAAC,KAAK,EAAE,WAAW,CAAC;IAC5B,QAAQ,CAAC,IAAI,EAAE,UAAU,CAAC;IAC1B,QAAQ,CAAC,MAAM,EAAE,iBAAiB,CAChC,KAAK,EACL,kBAAkB,EAClB,kBAAkB,EAClB,eAAe,EACf,eAAe,CAChB,CAAC;IACF,QAAQ,CAAC,UAAU,EAAE,iBAAiB,CACpC,QAAQ,EACR,qBAAqB,EACrB,qBAAqB,EACrB,kBAAkB,EAClB,kBAAkB,CACnB,CAAC;IACF,QAAQ,CAAC,MAAM,EAAE,iBAAiB,CAChC,KAAK,EACL,kBAAkB,EAClB,kBAAkB,EAClB,eAAe,EACf,eAAe,CAChB,CAAC;IACF,QAAQ,CAAC,QAAQ,EAAE,iBAAiB,CAClC,MAAM,EACN,mBAAmB,EACnB,mBAAmB,EACnB,gBAAgB,EAChB,gBAAgB,CACjB,CAAC;IACF,QAAQ,CAAC,SAAS,EAAE,iBAAiB,CACnC,QAAQ,EACR,qBAAqB,EACrB,qBAAqB,EACrB,kBAAkB,EAClB,kBAAkB,CACnB,CAAC;IACF,QAAQ,CAAC,UAAU,EAAE,iBAAiB,CACpC,SAAS,EACT,sBAAsB,EACtB,sBAAsB,EACtB,mBAAmB,EACnB,mBAAmB,CACpB,CAAC;IACF,QAAQ,CAAC,YAAY,EAAE,iBAAiB,CACtC,WAAW,EACX,wBAAwB,EACxB,wBAAwB,EACxB,qBAAqB,EACrB,qBAAqB,CACtB,CAAC;IACF,QAAQ,CAAC,YAAY,EAAE,gBAAgB,CACrC,YAAY,EACZ,yBAAyB,EACzB,yBAAyB,EACzB,sBAAsB,EACtB,sBAAsB,EACtB,wBAAwB,EACxB,iBAAiB,CAClB,CAAC;IACF,QAAQ,CAAC,SAAS,EAAE,gBAAgB,CAClC,QAAQ,EACR,qBAAqB,EACrB,qBAAqB,EACrB,kBAAkB,EAClB,kBAAkB,EAClB,YAAY,EACZ,aAAa,CACd,CAAC;IACF,QAAQ,CAAC,oBAAoB,EAAE,gBAAgB,CAC7C,mBAAmB,EACnB,gCAAgC,EAChC,gCAAgC,EAChC,6BAA6B,EAC7B,6BAA6B,EAC7B,YAAY,EACZ,MAAM,CAAC,MAAM,EAAE,KAAK,CAAC,CACtB,CAAC;IACF,QAAQ,CAAC,qBAAqB,EAAE,gBAAgB,CAC9C,oBAAoB,EACpB,iCAAiC,EACjC,iCAAiC,EACjC,8BAA8B,EAC9B,8BAA8B,EAC9B,YAAY,EACZ,MAAM,CAAC,MAAM,EAAE,KAAK,CAAC,CACtB,CAAC;IACF,QAAQ,CAAC,kBAAkB,EAAE,gBAAgB,CAC3C,iBAAiB,EACjB,8BAA8B,EAC9B,8BAA8B,EAC9B,2BAA2B,EAC3B,2BAA2B,EAC3B,YAAY,EACZ,sBAAsB,CACvB,CAAC;IACF,QAAQ,CAAC,eAAe,EAAE,gBAAgB,CACxC,cAAc,EACd,2BAA2B,EAC3B,2BAA2B,EAC3B,wBAAwB,EACxB,wBAAwB,EACxB,YAAY,EACZ,mBAAmB,CACpB,CAAC;IACF,QAAQ,CAAC,KAAK,EAAE,UAAU,CAAC,IAAI,EAAE,iBAAiB,EAAE,iBAAiB,CAAC,CAAC;IACvE,QAAQ,CAAC,SAAS,EAAE,eAAe,CAAC;IACpC,QAAQ,CAAC,OAAO,EAAE,aAAa,CAAC;gBAEpB,MAAM,EAAE,YAAY;IA2B1B,OAAO,IAAI,OAAO,CAAC,MAAM,CAAC;IAQ1B,SAAS,IAAI,OAAO,CAAC;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC;CAOhE"}
+{"version":3,"file":"sales-planner-client.d.ts","sourceRoot":"","sources":["../../src/clients/sales-planner-client.ts"],"names":[],"mappings":"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"}

package/dist/clients/sales-planner-client.js

@@ -10,6 +10,8 @@ import { ShopsClient } from './shops-client.js';
 import { SkusClient } from './skus-client.js';
 import { UserRolesClient } from './user-roles-client.js';
 import { ApiKeysClient } from './api-keys-client.js';
+import { SkuMetricsClient } from './sku-metrics-client.js';
+import { ComputedEntitiesClient } from './computed-entities-client.js';
 export class SalesPlannerClient {
     baseUrl;
     // Sub-clients
@@ -35,6 +37,8 @@ export class SalesPlannerClient {
     roles;
     userRoles;
     apiKeys;
+    skuMetrics;
+    computed;
     constructor(config) {
         this.baseUrl = config.baseUrl.replace(/\/$/, '');
         this.me = new MeClient(config);
@@ -59,6 +63,8 @@ export class SalesPlannerClient {
         this.roles = new CrudClient(config, 'roles');
         this.userRoles = new UserRolesClient(config);
         this.apiKeys = new ApiKeysClient(config);
+        this.skuMetrics = new SkuMetricsClient(config);
+        this.computed = new ComputedEntitiesClient(config);
     }
     // Health & Info (unauthenticated)
     async getRoot() {

package/dist/clients/sku-metrics-client.d.ts

@@ -0,0 +1,29 @@
+import type { PaginatedResponse, PaginationQuery, SkuMetrics } from '@sales-planner/shared';
+import { BaseClient } from './base-client.js';
+/**
+ * Client for read-only SKU metrics computed from materialized views.
+ * SKU metrics include ABC classification, sales rank, and days of stock.
+ */
+export declare class SkuMetricsClient extends BaseClient {
+    /**
+     * List SKU metrics for a shop with pagination
+     */
+    list(shopId: number, tenantId: number, query?: PaginationQuery): Promise<PaginatedResponse<SkuMetrics>>;
+    /**
+     * Get a single SKU metric by ID
+     */
+    get(id: number, shopId: number, tenantId: number): Promise<SkuMetrics>;
+    /**
+     * Get SKU metrics filtered by ABC classification
+     */
+    getByAbcClass(abcClass: 'A' | 'B' | 'C', shopId: number, tenantId: number): Promise<SkuMetrics[]>;
+    /**
+     * Export SKU metrics as CSV
+     */
+    exportCsv(shopId: number, tenantId: number): Promise<string>;
+    /**
+     * Export SKU metrics as JSON
+     */
+    exportJson(shopId: number, tenantId: number): Promise<SkuMetrics[]>;
+}
+//# sourceMappingURL=sku-metrics-client.d.ts.map

package/dist/clients/sku-metrics-client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sku-metrics-client.d.ts","sourceRoot":"","sources":["../../src/clients/sku-metrics-client.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,eAAe,EAAE,UAAU,EAAE,MAAM,uBAAuB,CAAC;AAC5F,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAE9C;;;GAGG;AACH,qBAAa,gBAAiB,SAAQ,UAAU;IAC9C;;OAEG;IACG,IAAI,CACR,MAAM,EAAE,MAAM,EACd,QAAQ,EAAE,MAAM,EAChB,KAAK,CAAC,EAAE,eAAe,GACtB,OAAO,CAAC,iBAAiB,CAAC,UAAU,CAAC,CAAC;IAUzC;;OAEG;IACG,GAAG,CAAC,EAAE,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,CAAC;IAS5E;;OAEG;IACG,aAAa,CACjB,QAAQ,EAAE,GAAG,GAAG,GAAG,GAAG,GAAG,EACzB,MAAM,EAAE,MAAM,EACd,QAAQ,EAAE,MAAM,GACf,OAAO,CAAC,UAAU,EAAE,CAAC;IASxB;;OAEG;IACG,SAAS,CAAC,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IASlE;;OAEG;IACG,UAAU,CAAC,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,EAAE,CAAC;CAQ1E"}

package/dist/clients/sku-metrics-client.js

@@ -0,0 +1,63 @@
+import { BaseClient } from './base-client.js';
+/**
+ * Client for read-only SKU metrics computed from materialized views.
+ * SKU metrics include ABC classification, sales rank, and days of stock.
+ */
+export class SkuMetricsClient extends BaseClient {
+    /**
+     * List SKU metrics for a shop with pagination
+     */
+    async list(shopId, tenantId, query) {
+        return this.request('GET', '/sku-metrics', {
+            params: {
+                shop_id: shopId,
+                tenant_id: tenantId,
+                ...query,
+            },
+        });
+    }
+    /**
+     * Get a single SKU metric by ID
+     */
+    async get(id, shopId, tenantId) {
+        return this.request('GET', `/sku-metrics/${id}`, {
+            params: {
+                shop_id: shopId,
+                tenant_id: tenantId,
+            },
+        });
+    }
+    /**
+     * Get SKU metrics filtered by ABC classification
+     */
+    async getByAbcClass(abcClass, shopId, tenantId) {
+        return this.request('GET', `/sku-metrics/abc/${abcClass}`, {
+            params: {
+                shop_id: shopId,
+                tenant_id: tenantId,
+            },
+        });
+    }
+    /**
+     * Export SKU metrics as CSV
+     */
+    async exportCsv(shopId, tenantId) {
+        return this.requestText('GET', '/sku-metrics/export/csv', {
+            params: {
+                shop_id: shopId,
+                tenant_id: tenantId,
+            },
+        });
+    }
+    /**
+     * Export SKU metrics as JSON
+     */
+    async exportJson(shopId, tenantId) {
+        return this.request('GET', '/sku-metrics/export/json', {
+            params: {
+                shop_id: shopId,
+                tenant_id: tenantId,
+            },
+        });
+    }
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@sales-planner/http-client",
-  "version": "0.17.3",
+  "version": "0.19.0",
   "description": "HTTP client for Sales Planner API",
   "author": "Damir Manapov",
   "license": "MIT",
@@ -23,17 +23,17 @@
     "dist",
     "README.md"
   ],
+  "dependencies": {
+    "@sales-planner/shared": "0.17.0"
+  },
+  "devDependencies": {
+    "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"
-  },
-  "dependencies": {
-    "@sales-planner/shared": "workspace:*"
-  },
-  "devDependencies": {
-    "typescript": "^5.7.3"
   }
-}
+}