@sales-planner/http-client 0.18.0 → 0.19.0

package/README.md

@@ -128,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
@@ -340,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
 
@@ -388,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

@@ -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;
@@ -35,6 +37,8 @@ export declare class SalesPlannerClient {
     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":"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"}
+{"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.18.0",
+  "version": "0.19.0",
   "description": "HTTP client for Sales Planner API",
   "author": "Damir Manapov",
   "license": "MIT",
@@ -24,7 +24,7 @@
     "README.md"
   ],
   "dependencies": {
-    "@sales-planner/shared": "0.16.0"
+    "@sales-planner/shared": "0.17.0"
   },
   "devDependencies": {
     "typescript": "^5.7.3"