krawlet-js 1.3.4 → 2.0.1

package/dist/index.cjs

@@ -425,7 +425,7 @@ var StorageResource = class {
   }
   /**
    * Store ender storage data (requires authentication)
-   * @param data - Any JSON object to store
+   * @param data - Ender storage payload to store
    * @param token - Ender Storage API token
    * @returns Success message and timestamp
    * @throws KrawletError with BAD_REQUEST if data is invalid
@@ -464,11 +464,14 @@ var ReportsResource = class {
    * @returns Validation failure records
    */
   async getValidationFailures(options) {
-    const response = await this.client.request("/v1/reports/validation-failures", {
-      params: {
-        limit: options?.limit || 50
+    const response = await this.client.request(
+      "/v1/reports/validation-failures",
+      {
+        params: {
+          limit: options?.limit || 50
+        }
       }
-    });
+    );
     return response.data;
   }
   /**
@@ -478,11 +481,14 @@ var ReportsResource = class {
    * @returns Successful post records
    */
   async getSuccessfulPosts(options) {
-    const response = await this.client.request("/v1/reports/successful-posts", {
-      params: {
-        limit: options?.limit || 50
+    const response = await this.client.request(
+      "/v1/reports/successful-posts",
+      {
+        params: {
+          limit: options?.limit || 50
+        }
       }
-    });
+    );
     return response.data;
   }
   /**
@@ -493,12 +499,18 @@ var ReportsResource = class {
    * @returns Shop change event records
    */
   async getShopChanges(options) {
-    const response = await this.client.request("/v1/reports/shop-changes", {
-      params: {
-        limit: options?.limit || 50,
-        shopId: options?.shopId
+    const response = await this.client.request(
+      "/v1/reports/shop-changes",
+      {
+        params: {
+          limit: options?.limit || 50,
+          shopId: options?.shopId,
+          since: options?.since,
+          until: options?.until,
+          source: options?.source
+        }
       }
-    });
+    );
     return response.data;
   }
   /**
@@ -509,63 +521,79 @@ var ReportsResource = class {
    * @returns Item change event records
    */
   async getItemChanges(options) {
-    const response = await this.client.request("/v1/reports/item-changes", {
-      params: {
-        limit: options?.limit || 50,
-        shopId: options?.shopId
+    const response = await this.client.request(
+      "/v1/reports/item-changes",
+      {
+        params: {
+          limit: options?.limit || 50,
+          shopId: options?.shopId,
+          changeType: options?.changeType,
+          since: options?.since,
+          until: options?.until,
+          source: options?.source
+        }
       }
-    });
+    );
     return response.data;
   }
   /**
    * Retrieve shop change logs from the database
    * @param options - Query options including pagination and filtering
-   * @returns Shop change logs
+   * @returns Response containing count (number of logs in this response), total (total logs matching query), and logs (array of ShopChangeLog)
    */
   async getShopChangeLogs(options) {
-    const response = await this.client.request("/v1/reports/shop-change-logs", {
-      params: {
-        limit: options?.limit,
-        offset: options?.offset,
-        shopId: options?.shopId,
-        since: options?.since,
-        until: options?.until
+    const response = await this.client.request(
+      "/v1/reports/shop-change-logs",
+      {
+        params: {
+          limit: options?.limit,
+          offset: options?.offset,
+          shopId: options?.shopId,
+          since: options?.since,
+          until: options?.until
+        }
       }
-    });
+    );
     return response.data;
   }
   /**
    * Retrieve item change logs from the database
    * @param options - Query options including pagination and filtering
-   * @returns Item change logs
+   * @returns Response containing count (number of logs in this response), total (total logs matching query), and logs (array of ItemChangeLog)
    */
   async getItemChangeLogs(options) {
-    const response = await this.client.request("/v1/reports/item-change-logs", {
-      params: {
-        limit: options?.limit,
-        offset: options?.offset,
-        shopId: options?.shopId,
-        since: options?.since,
-        until: options?.until
+    const response = await this.client.request(
+      "/v1/reports/item-change-logs",
+      {
+        params: {
+          limit: options?.limit,
+          offset: options?.offset,
+          shopId: options?.shopId,
+          since: options?.since,
+          until: options?.until
+        }
       }
-    });
+    );
     return response.data;
   }
   /**
    * Retrieve price change logs from the database
    * @param options - Query options including pagination and filtering
-   * @returns Price change logs
+   * @returns Response containing count (number of logs in this response), total (total logs matching query), and logs (array of PriceChangeLog)
    */
   async getPriceChangeLogs(options) {
-    const response = await this.client.request("/v1/reports/price-change-logs", {
-      params: {
-        limit: options?.limit,
-        offset: options?.offset,
-        shopId: options?.shopId,
-        since: options?.since,
-        until: options?.until
+    const response = await this.client.request(
+      "/v1/reports/price-change-logs",
+      {
+        params: {
+          limit: options?.limit,
+          offset: options?.offset,
+          shopId: options?.shopId,
+          since: options?.since,
+          until: options?.until
+        }
       }
-    });
+    );
     return response.data;
   }
   /**

package/dist/index.d.cts

@@ -113,6 +113,66 @@ interface PriceChangeLog {
     createdAt: string;
     updatedAt: string;
 }
+interface ShopChangeField {
+    field: string;
+    previousValue: unknown;
+    newValue: unknown;
+}
+interface ReporterStats {
+    validationFailures: number;
+    successfulPosts: number;
+    shopChanges: number;
+    itemChanges: number;
+    oldestRecord: string | null;
+    newestRecord: string | null;
+    persistent: {
+        shopChanges: number;
+        itemChanges: number;
+        priceChanges: number;
+        total: number;
+    };
+}
+interface ValidationFailureRecord {
+    id: string;
+    timestamp: string;
+    rawData: unknown;
+    errors: string[];
+    shopName?: string;
+    computerId?: number;
+}
+interface SuccessfulPostRecord {
+    id: string;
+    timestamp: string;
+    shopId: string;
+    shopName: string;
+    rawData: ShopSyncData;
+    itemCount: number;
+}
+interface ShopChangeRecord {
+    id: string;
+    timestamp: string;
+    shopId: string;
+    shopName: string;
+    changes: ShopChangeField[];
+    isNewShop: boolean;
+}
+interface ItemSummary {
+    name: string;
+    displayName: string;
+    hash: string;
+}
+interface ItemUpdateSummary extends ItemSummary {
+    changes: ShopChangeField[];
+}
+interface ItemChangeRecord {
+    id: string;
+    timestamp: string;
+    shopId: string;
+    shopName: string;
+    added: ItemSummary[];
+    removed: ItemSummary[];
+    updated: ItemUpdateSummary[];
+}
 interface ShopSyncData {
     sourceType?: ShopSourceType;
     info: {
@@ -290,18 +350,64 @@ interface DetailedHealthResponse {
     };
     services: HealthServicesDetailed;
 }
+type EnderStorageColor = {
+    name: string;
+    color: number;
+};
+type EnderStorageItem = {
+    name: string;
+    displayName: string;
+    rawName: string;
+    maxCount: number;
+    count: number;
+    mapColor?: number;
+    mapColour?: number;
+    itemGroups: Record<string, unknown>;
+    tags: Record<string, unknown>;
+    [key: string]: unknown;
+};
+type EnderStorageChest = {
+    colors: EnderStorageColor[];
+    contents: Record<string, EnderStorageItem>;
+    name?: string;
+    description?: string;
+    displayName?: string;
+    [key: string]: unknown;
+};
+type EnderStorageCollection = {
+    data: EnderStorageChest[];
+    retrievedAt: string;
+};
+type EnderStorageMeta = {
+    timestamp: string;
+    elapsed: number;
+    version: string;
+    requestId: string;
+    [key: string]: unknown;
+};
+type EnderStorageApiPayload = {
+    success: boolean;
+    data: EnderStorageCollection;
+    meta?: EnderStorageMeta;
+    [key: string]: unknown;
+};
+type EnderStoragePayload = EnderStorageApiPayload | EnderStorageChest[];
 interface StorageData {
-    data: unknown;
+    data: EnderStorageChest[];
     retrievedAt: string;
 }
-interface ReportRecords {
+interface ReportRecords<TRecord = unknown> {
     count: number;
-    records: unknown[];
+    records: TRecord[];
 }
-interface ChangeLogResult {
+interface ChangeLogResult<TLog = unknown> {
     count: number;
-    logs: unknown[];
+    total: number;
+    logs: TLog[];
 }
+type ShopChangeLogResponse = ChangeLogResult<ShopChangeLog>;
+type ItemChangeLogResponse = ChangeLogResult<ItemChangeLog>;
+type PriceChangeLogResponse = ChangeLogResult<PriceChangeLog>;
 interface ChangeLogOptions {
     limit?: number;
     offset?: number;
@@ -309,6 +415,29 @@ interface ChangeLogOptions {
     since?: string;
     until?: string;
 }
+interface BaseQueryParams {
+    limit?: number;
+    offset?: number;
+}
+interface ShopChangesParams extends BaseQueryParams {
+    shopId?: string;
+    since?: string;
+    until?: string;
+    source?: 'memory' | 'persistent' | 'both';
+}
+interface ItemChangesParams extends BaseQueryParams {
+    shopId?: string;
+    changeType?: 'added' | 'removed';
+    since?: string;
+    until?: string;
+    source?: 'memory' | 'persistent' | 'both';
+}
+interface PriceChangesParams extends BaseQueryParams {
+    shopId?: string;
+    itemHash?: string;
+    since?: string;
+    until?: string;
+}
 
 interface HttpClientConfig {
     baseUrl: string;
@@ -389,7 +518,7 @@ declare class StorageResource {
     private client;
     constructor(client: HttpClient);
     get(): Promise<StorageData>;
-    set(data: unknown, token: string): Promise<{
+    set(data: EnderStoragePayload, token: string): Promise<{
         message: string;
         timestamp: string;
     }>;
@@ -398,24 +527,18 @@ declare class StorageResource {
 declare class ReportsResource {
     private client;
     constructor(client: HttpClient);
-    getStats(): Promise<unknown>;
+    getStats(): Promise<ReporterStats>;
     getValidationFailures(options?: {
         limit?: number;
-    }): Promise<ReportRecords>;
+    }): Promise<ReportRecords<ValidationFailureRecord>>;
     getSuccessfulPosts(options?: {
         limit?: number;
-    }): Promise<ReportRecords>;
-    getShopChanges(options?: {
-        limit?: number;
-        shopId?: string;
-    }): Promise<ReportRecords>;
-    getItemChanges(options?: {
-        limit?: number;
-        shopId?: string;
-    }): Promise<ReportRecords>;
-    getShopChangeLogs(options?: ChangeLogOptions): Promise<ChangeLogResult>;
-    getItemChangeLogs(options?: ChangeLogOptions): Promise<ChangeLogResult>;
-    getPriceChangeLogs(options?: ChangeLogOptions): Promise<ChangeLogResult>;
+    }): Promise<ReportRecords<SuccessfulPostRecord>>;
+    getShopChanges(options?: ShopChangesParams): Promise<ReportRecords<ShopChangeRecord>>;
+    getItemChanges(options?: ItemChangesParams): Promise<ReportRecords<ItemChangeRecord>>;
+    getShopChangeLogs(options?: ChangeLogOptions): Promise<ShopChangeLogResponse>;
+    getItemChangeLogs(options?: ChangeLogOptions): Promise<ItemChangeLogResponse>;
+    getPriceChangeLogs(options?: ChangeLogOptions): Promise<PriceChangeLogResponse>;
     get(id: string): Promise<unknown>;
 }
 
@@ -470,4 +593,4 @@ declare class KrawletError extends Error {
     isRateLimitError(): boolean;
 }
 
-export { AddressesResource, type ApiKeyInfo, ApiKeyResource, type ApiKeyTier, type ApiKeyUsage, type ApiResponse, type ApiResponseMeta, type ChangeLogOptions, type ChangeLogResult, type ChatboxServiceInfo, type DetailedHealthResponse, type DiscordServiceInfo, ErrorCode, type ErrorResponse, type HealthChecks, HealthResource, type HealthResponse, type HealthServices, type HealthServicesDetailed, type Item, type ItemChangeLog, type ItemChangeType, ItemsResource, type KnownAddress, type KnownAddressType, KrawletClient, type KrawletClientConfig, KrawletError, type KromerServiceInfo, type Player, type PlayerNotifications, PlayersResource, type Price, type PriceChangeLog, type QuickCodeGenerateResponse, type QuickCodeRedeemResponse, type RateLimit, type ReportRecords, ReportsResource, type RequestLog, type RequestLogsResponse, type ServiceInfo, type ServiceName, type ServiceStatus, type Shop, type ShopChangeLog, type ShopSourceType, type ShopSyncData, ShopsResource, type StorageData, StorageResource };
+export { AddressesResource, type ApiKeyInfo, ApiKeyResource, type ApiKeyTier, type ApiKeyUsage, type ApiResponse, type ApiResponseMeta, type BaseQueryParams, type ChangeLogOptions, type ChangeLogResult, type ChatboxServiceInfo, type DetailedHealthResponse, type DiscordServiceInfo, type EnderStorageApiPayload, type EnderStorageChest, type EnderStorageCollection, type EnderStorageColor, type EnderStorageItem, type EnderStorageMeta, type EnderStoragePayload, ErrorCode, type ErrorResponse, type HealthChecks, HealthResource, type HealthResponse, type HealthServices, type HealthServicesDetailed, type Item, type ItemChangeLog, type ItemChangeLogResponse, type ItemChangeRecord, type ItemChangeType, type ItemChangesParams, type ItemSummary, type ItemUpdateSummary, ItemsResource, type KnownAddress, type KnownAddressType, KrawletClient, type KrawletClientConfig, KrawletError, type KromerServiceInfo, type Player, type PlayerNotifications, PlayersResource, type Price, type PriceChangeLog, type PriceChangeLogResponse, type PriceChangesParams, type QuickCodeGenerateResponse, type QuickCodeRedeemResponse, type RateLimit, type ReportRecords, type ReporterStats, ReportsResource, type RequestLog, type RequestLogsResponse, type ServiceInfo, type ServiceName, type ServiceStatus, type Shop, type ShopChangeField, type ShopChangeLog, type ShopChangeLogResponse, type ShopChangeRecord, type ShopChangesParams, type ShopSourceType, type ShopSyncData, ShopsResource, type StorageData, StorageResource, type SuccessfulPostRecord, type ValidationFailureRecord };

package/dist/index.d.ts

@@ -113,6 +113,66 @@ interface PriceChangeLog {
     createdAt: string;
     updatedAt: string;
 }
+interface ShopChangeField {
+    field: string;
+    previousValue: unknown;
+    newValue: unknown;
+}
+interface ReporterStats {
+    validationFailures: number;
+    successfulPosts: number;
+    shopChanges: number;
+    itemChanges: number;
+    oldestRecord: string | null;
+    newestRecord: string | null;
+    persistent: {
+        shopChanges: number;
+        itemChanges: number;
+        priceChanges: number;
+        total: number;
+    };
+}
+interface ValidationFailureRecord {
+    id: string;
+    timestamp: string;
+    rawData: unknown;
+    errors: string[];
+    shopName?: string;
+    computerId?: number;
+}
+interface SuccessfulPostRecord {
+    id: string;
+    timestamp: string;
+    shopId: string;
+    shopName: string;
+    rawData: ShopSyncData;
+    itemCount: number;
+}
+interface ShopChangeRecord {
+    id: string;
+    timestamp: string;
+    shopId: string;
+    shopName: string;
+    changes: ShopChangeField[];
+    isNewShop: boolean;
+}
+interface ItemSummary {
+    name: string;
+    displayName: string;
+    hash: string;
+}
+interface ItemUpdateSummary extends ItemSummary {
+    changes: ShopChangeField[];
+}
+interface ItemChangeRecord {
+    id: string;
+    timestamp: string;
+    shopId: string;
+    shopName: string;
+    added: ItemSummary[];
+    removed: ItemSummary[];
+    updated: ItemUpdateSummary[];
+}
 interface ShopSyncData {
     sourceType?: ShopSourceType;
     info: {
@@ -290,18 +350,64 @@ interface DetailedHealthResponse {
     };
     services: HealthServicesDetailed;
 }
+type EnderStorageColor = {
+    name: string;
+    color: number;
+};
+type EnderStorageItem = {
+    name: string;
+    displayName: string;
+    rawName: string;
+    maxCount: number;
+    count: number;
+    mapColor?: number;
+    mapColour?: number;
+    itemGroups: Record<string, unknown>;
+    tags: Record<string, unknown>;
+    [key: string]: unknown;
+};
+type EnderStorageChest = {
+    colors: EnderStorageColor[];
+    contents: Record<string, EnderStorageItem>;
+    name?: string;
+    description?: string;
+    displayName?: string;
+    [key: string]: unknown;
+};
+type EnderStorageCollection = {
+    data: EnderStorageChest[];
+    retrievedAt: string;
+};
+type EnderStorageMeta = {
+    timestamp: string;
+    elapsed: number;
+    version: string;
+    requestId: string;
+    [key: string]: unknown;
+};
+type EnderStorageApiPayload = {
+    success: boolean;
+    data: EnderStorageCollection;
+    meta?: EnderStorageMeta;
+    [key: string]: unknown;
+};
+type EnderStoragePayload = EnderStorageApiPayload | EnderStorageChest[];
 interface StorageData {
-    data: unknown;
+    data: EnderStorageChest[];
     retrievedAt: string;
 }
-interface ReportRecords {
+interface ReportRecords<TRecord = unknown> {
     count: number;
-    records: unknown[];
+    records: TRecord[];
 }
-interface ChangeLogResult {
+interface ChangeLogResult<TLog = unknown> {
     count: number;
-    logs: unknown[];
+    total: number;
+    logs: TLog[];
 }
+type ShopChangeLogResponse = ChangeLogResult<ShopChangeLog>;
+type ItemChangeLogResponse = ChangeLogResult<ItemChangeLog>;
+type PriceChangeLogResponse = ChangeLogResult<PriceChangeLog>;
 interface ChangeLogOptions {
     limit?: number;
     offset?: number;
@@ -309,6 +415,29 @@ interface ChangeLogOptions {
     since?: string;
     until?: string;
 }
+interface BaseQueryParams {
+    limit?: number;
+    offset?: number;
+}
+interface ShopChangesParams extends BaseQueryParams {
+    shopId?: string;
+    since?: string;
+    until?: string;
+    source?: 'memory' | 'persistent' | 'both';
+}
+interface ItemChangesParams extends BaseQueryParams {
+    shopId?: string;
+    changeType?: 'added' | 'removed';
+    since?: string;
+    until?: string;
+    source?: 'memory' | 'persistent' | 'both';
+}
+interface PriceChangesParams extends BaseQueryParams {
+    shopId?: string;
+    itemHash?: string;
+    since?: string;
+    until?: string;
+}
 
 interface HttpClientConfig {
     baseUrl: string;
@@ -389,7 +518,7 @@ declare class StorageResource {
     private client;
     constructor(client: HttpClient);
     get(): Promise<StorageData>;
-    set(data: unknown, token: string): Promise<{
+    set(data: EnderStoragePayload, token: string): Promise<{
         message: string;
         timestamp: string;
     }>;
@@ -398,24 +527,18 @@ declare class StorageResource {
 declare class ReportsResource {
     private client;
     constructor(client: HttpClient);
-    getStats(): Promise<unknown>;
+    getStats(): Promise<ReporterStats>;
     getValidationFailures(options?: {
         limit?: number;
-    }): Promise<ReportRecords>;
+    }): Promise<ReportRecords<ValidationFailureRecord>>;
     getSuccessfulPosts(options?: {
         limit?: number;
-    }): Promise<ReportRecords>;
-    getShopChanges(options?: {
-        limit?: number;
-        shopId?: string;
-    }): Promise<ReportRecords>;
-    getItemChanges(options?: {
-        limit?: number;
-        shopId?: string;
-    }): Promise<ReportRecords>;
-    getShopChangeLogs(options?: ChangeLogOptions): Promise<ChangeLogResult>;
-    getItemChangeLogs(options?: ChangeLogOptions): Promise<ChangeLogResult>;
-    getPriceChangeLogs(options?: ChangeLogOptions): Promise<ChangeLogResult>;
+    }): Promise<ReportRecords<SuccessfulPostRecord>>;
+    getShopChanges(options?: ShopChangesParams): Promise<ReportRecords<ShopChangeRecord>>;
+    getItemChanges(options?: ItemChangesParams): Promise<ReportRecords<ItemChangeRecord>>;
+    getShopChangeLogs(options?: ChangeLogOptions): Promise<ShopChangeLogResponse>;
+    getItemChangeLogs(options?: ChangeLogOptions): Promise<ItemChangeLogResponse>;
+    getPriceChangeLogs(options?: ChangeLogOptions): Promise<PriceChangeLogResponse>;
     get(id: string): Promise<unknown>;
 }
 
@@ -470,4 +593,4 @@ declare class KrawletError extends Error {
     isRateLimitError(): boolean;
 }
 
-export { AddressesResource, type ApiKeyInfo, ApiKeyResource, type ApiKeyTier, type ApiKeyUsage, type ApiResponse, type ApiResponseMeta, type ChangeLogOptions, type ChangeLogResult, type ChatboxServiceInfo, type DetailedHealthResponse, type DiscordServiceInfo, ErrorCode, type ErrorResponse, type HealthChecks, HealthResource, type HealthResponse, type HealthServices, type HealthServicesDetailed, type Item, type ItemChangeLog, type ItemChangeType, ItemsResource, type KnownAddress, type KnownAddressType, KrawletClient, type KrawletClientConfig, KrawletError, type KromerServiceInfo, type Player, type PlayerNotifications, PlayersResource, type Price, type PriceChangeLog, type QuickCodeGenerateResponse, type QuickCodeRedeemResponse, type RateLimit, type ReportRecords, ReportsResource, type RequestLog, type RequestLogsResponse, type ServiceInfo, type ServiceName, type ServiceStatus, type Shop, type ShopChangeLog, type ShopSourceType, type ShopSyncData, ShopsResource, type StorageData, StorageResource };
+export { AddressesResource, type ApiKeyInfo, ApiKeyResource, type ApiKeyTier, type ApiKeyUsage, type ApiResponse, type ApiResponseMeta, type BaseQueryParams, type ChangeLogOptions, type ChangeLogResult, type ChatboxServiceInfo, type DetailedHealthResponse, type DiscordServiceInfo, type EnderStorageApiPayload, type EnderStorageChest, type EnderStorageCollection, type EnderStorageColor, type EnderStorageItem, type EnderStorageMeta, type EnderStoragePayload, ErrorCode, type ErrorResponse, type HealthChecks, HealthResource, type HealthResponse, type HealthServices, type HealthServicesDetailed, type Item, type ItemChangeLog, type ItemChangeLogResponse, type ItemChangeRecord, type ItemChangeType, type ItemChangesParams, type ItemSummary, type ItemUpdateSummary, ItemsResource, type KnownAddress, type KnownAddressType, KrawletClient, type KrawletClientConfig, KrawletError, type KromerServiceInfo, type Player, type PlayerNotifications, PlayersResource, type Price, type PriceChangeLog, type PriceChangeLogResponse, type PriceChangesParams, type QuickCodeGenerateResponse, type QuickCodeRedeemResponse, type RateLimit, type ReportRecords, type ReporterStats, ReportsResource, type RequestLog, type RequestLogsResponse, type ServiceInfo, type ServiceName, type ServiceStatus, type Shop, type ShopChangeField, type ShopChangeLog, type ShopChangeLogResponse, type ShopChangeRecord, type ShopChangesParams, type ShopSourceType, type ShopSyncData, ShopsResource, type StorageData, StorageResource, type SuccessfulPostRecord, type ValidationFailureRecord };

package/dist/index.js

@@ -389,7 +389,7 @@ var StorageResource = class {
   }
   /**
    * Store ender storage data (requires authentication)
-   * @param data - Any JSON object to store
+   * @param data - Ender storage payload to store
    * @param token - Ender Storage API token
    * @returns Success message and timestamp
    * @throws KrawletError with BAD_REQUEST if data is invalid
@@ -428,11 +428,14 @@ var ReportsResource = class {
    * @returns Validation failure records
    */
   async getValidationFailures(options) {
-    const response = await this.client.request("/v1/reports/validation-failures", {
-      params: {
-        limit: options?.limit || 50
+    const response = await this.client.request(
+      "/v1/reports/validation-failures",
+      {
+        params: {
+          limit: options?.limit || 50
+        }
       }
-    });
+    );
     return response.data;
   }
   /**
@@ -442,11 +445,14 @@ var ReportsResource = class {
    * @returns Successful post records
    */
   async getSuccessfulPosts(options) {
-    const response = await this.client.request("/v1/reports/successful-posts", {
-      params: {
-        limit: options?.limit || 50
+    const response = await this.client.request(
+      "/v1/reports/successful-posts",
+      {
+        params: {
+          limit: options?.limit || 50
+        }
       }
-    });
+    );
     return response.data;
   }
   /**
@@ -457,12 +463,18 @@ var ReportsResource = class {
    * @returns Shop change event records
    */
   async getShopChanges(options) {
-    const response = await this.client.request("/v1/reports/shop-changes", {
-      params: {
-        limit: options?.limit || 50,
-        shopId: options?.shopId
+    const response = await this.client.request(
+      "/v1/reports/shop-changes",
+      {
+        params: {
+          limit: options?.limit || 50,
+          shopId: options?.shopId,
+          since: options?.since,
+          until: options?.until,
+          source: options?.source
+        }
       }
-    });
+    );
     return response.data;
   }
   /**
@@ -473,63 +485,79 @@ var ReportsResource = class {
    * @returns Item change event records
    */
   async getItemChanges(options) {
-    const response = await this.client.request("/v1/reports/item-changes", {
-      params: {
-        limit: options?.limit || 50,
-        shopId: options?.shopId
+    const response = await this.client.request(
+      "/v1/reports/item-changes",
+      {
+        params: {
+          limit: options?.limit || 50,
+          shopId: options?.shopId,
+          changeType: options?.changeType,
+          since: options?.since,
+          until: options?.until,
+          source: options?.source
+        }
       }
-    });
+    );
     return response.data;
   }
   /**
    * Retrieve shop change logs from the database
    * @param options - Query options including pagination and filtering
-   * @returns Shop change logs
+   * @returns Response containing count (number of logs in this response), total (total logs matching query), and logs (array of ShopChangeLog)
    */
   async getShopChangeLogs(options) {
-    const response = await this.client.request("/v1/reports/shop-change-logs", {
-      params: {
-        limit: options?.limit,
-        offset: options?.offset,
-        shopId: options?.shopId,
-        since: options?.since,
-        until: options?.until
+    const response = await this.client.request(
+      "/v1/reports/shop-change-logs",
+      {
+        params: {
+          limit: options?.limit,
+          offset: options?.offset,
+          shopId: options?.shopId,
+          since: options?.since,
+          until: options?.until
+        }
       }
-    });
+    );
     return response.data;
   }
   /**
    * Retrieve item change logs from the database
    * @param options - Query options including pagination and filtering
-   * @returns Item change logs
+   * @returns Response containing count (number of logs in this response), total (total logs matching query), and logs (array of ItemChangeLog)
    */
   async getItemChangeLogs(options) {
-    const response = await this.client.request("/v1/reports/item-change-logs", {
-      params: {
-        limit: options?.limit,
-        offset: options?.offset,
-        shopId: options?.shopId,
-        since: options?.since,
-        until: options?.until
+    const response = await this.client.request(
+      "/v1/reports/item-change-logs",
+      {
+        params: {
+          limit: options?.limit,
+          offset: options?.offset,
+          shopId: options?.shopId,
+          since: options?.since,
+          until: options?.until
+        }
       }
-    });
+    );
     return response.data;
   }
   /**
    * Retrieve price change logs from the database
    * @param options - Query options including pagination and filtering
-   * @returns Price change logs
+   * @returns Response containing count (number of logs in this response), total (total logs matching query), and logs (array of PriceChangeLog)
    */
   async getPriceChangeLogs(options) {
-    const response = await this.client.request("/v1/reports/price-change-logs", {
-      params: {
-        limit: options?.limit,
-        offset: options?.offset,
-        shopId: options?.shopId,
-        since: options?.since,
-        until: options?.until
+    const response = await this.client.request(
+      "/v1/reports/price-change-logs",
+      {
+        params: {
+          limit: options?.limit,
+          offset: options?.offset,
+          shopId: options?.shopId,
+          since: options?.since,
+          until: options?.until
+        }
       }
-    });
+    );
     return response.data;
   }
   /**

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "krawlet-js",
-  "version": "1.3.4",
+  "version": "2.0.1",
   "description": "TypeScript/JavaScript client library for the Krawlet Minecraft economy tracking API",
   "type": "module",
   "main": "dist/index.cjs",
@@ -31,14 +31,15 @@
   },
   "devDependencies": {
     "@types/node": "^22.10.5",
-    "@typescript-eslint/eslint-plugin": "^8.20.0",
-    "@typescript-eslint/parser": "^8.20.0",
-    "@vitest/coverage-v8": "^2.1.8",
-    "eslint": "^9.18.0",
+    "@typescript-eslint/eslint-plugin": "^8.58.1",
+    "@typescript-eslint/parser": "^8.58.1",
+    "@vitest/coverage-v8": "^4.1.4",
+    "eslint": "^9.39.4",
     "prettier": "^3.4.2",
-    "tsup": "^8.3.5",
+    "tsup": "^8.5.1",
     "typescript": "^5.7.2",
-    "vitest": "^2.1.8"
+    "vite": "^8.0.8",
+    "vitest": "^4.1.4"
   },
   "scripts": {
     "build": "tsup src/index.ts --format cjs,esm --dts --clean",