krawlet-js 1.3.5 → 2.1.0

package/dist/index.cjs

@@ -30,7 +30,8 @@ __export(index_exports, {
   PlayersResource: () => PlayersResource,
   ReportsResource: () => ReportsResource,
   ShopsResource: () => ShopsResource,
-  StorageResource: () => StorageResource
+  StorageResource: () => StorageResource,
+  TransfersResource: () => TransfersResource
 });
 module.exports = __toCommonJS(index_exports);
 
@@ -425,7 +426,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 +465,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 +482,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 +500,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,12 +522,19 @@ 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;
   }
   /**
@@ -523,15 +543,18 @@ var ReportsResource = class {
    * @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;
   }
   /**
@@ -540,15 +563,18 @@ var ReportsResource = class {
    * @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;
   }
   /**
@@ -557,15 +583,18 @@ var ReportsResource = class {
    * @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;
   }
   /**
@@ -721,6 +750,84 @@ var ApiKeyResource = class {
   }
 };
 
+// src/resources/transfers.ts
+var TransfersResource = class {
+  constructor(client) {
+    this.client = client;
+  }
+  /**
+   * List all transfers where the authenticated player is sender or recipient
+   * @returns Array of transfer records
+   */
+  async getAll() {
+    const response = await this.client.request("/v1/transfers");
+    return response.data;
+  }
+  /**
+   * Queue a new transfer request
+   * @param data - Transfer request payload
+   * @returns Transfer record
+   */
+  async create(data) {
+    const response = await this.client.request("/v1/transfers", {
+      method: "POST",
+      body: data
+    });
+    return response.data;
+  }
+  /**
+   * Retrieve transfer details by ID
+   * @param transferId - Transfer UUID
+   * @returns Transfer record
+   */
+  async get(transferId) {
+    const response = await this.client.request(`/v1/transfers/${transferId}`);
+    return response.data;
+  }
+  /**
+   * Cancel a pending or in-progress transfer
+   * @param transferId - Transfer UUID
+   * @returns Updated transfer record
+   */
+  async cancel(transferId) {
+    const response = await this.client.request(`/v1/transfers/${transferId}/cancel`, {
+      method: "POST"
+    });
+    return response.data;
+  }
+  /**
+   * Get current ender storage contents for the authenticated player
+   * @returns Contents snapshot
+   */
+  async getContents() {
+    const response = await this.client.request("/v1/transfers/contents");
+    return response.data;
+  }
+  /**
+   * List active transfer targets available to the authenticated user
+   * @returns Array of transfer targets
+   */
+  async getTargets() {
+    const response = await this.client.request("/v1/transfers/targets");
+    return response.data;
+  }
+  /**
+   * Request transfer from public/service storage into the authenticated player's storage
+   * @param data - Public storage transfer payload
+   * @returns Transfer and resolved source entity information
+   */
+  async requestPublicStorage(data) {
+    const response = await this.client.request(
+      "/v1/requests/public-storage",
+      {
+        method: "POST",
+        body: data
+      }
+    );
+    return response.data;
+  }
+};
+
 // src/client.ts
 var KrawletClient = class {
   /**
@@ -746,6 +853,7 @@ var KrawletClient = class {
     this.storage = new StorageResource(this.httpClient);
     this.reports = new ReportsResource(this.httpClient);
     this.apiKey = new ApiKeyResource(this.httpClient);
+    this.transfers = new TransfersResource(this.httpClient);
   }
   /**
    * Get the last known rate limit information
@@ -785,5 +893,6 @@ var ErrorCode = /* @__PURE__ */ ((ErrorCode2) => {
   PlayersResource,
   ReportsResource,
   ShopsResource,
-  StorageResource
+  StorageResource,
+  TransfersResource
 });

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,34 +350,123 @@ 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 StorageSlotItem {
+    name: string;
     count: number;
-    records: unknown[];
+    nbt?: string | null;
 }
-interface ChangeLogResult {
-    count: number;
-    total: number;
-    logs: unknown[];
+interface StorageSlotContents {
+    items: StorageSlotItem[];
 }
-interface ShopChangeLogResponse {
-    count: number;
-    total: number;
-    logs: ShopChangeLog[];
+interface TransferTargetLink {
+    type: string;
+    value: string;
 }
-interface ItemChangeLogResponse {
+interface TransferTarget {
+    id: string;
+    name: string;
+    type: string;
+    links: TransferTargetLink[];
+}
+type TransferStatus = 'pending' | 'in_progress' | 'completed' | 'failed' | 'cancelled';
+interface Transfer {
+    id: string;
+    status: TransferStatus;
+    error: string | null;
+    workerId?: number | null;
+    fromUUID: string;
+    fromUsername: string;
+    toUUID: string;
+    toUsername: string;
+    itemName: string | null;
+    itemNbt: string | null;
+    quantity: number | null;
+    quantityTransferred: number;
+    timestamp: string;
+}
+interface TransferCreateRequest {
+    to: string;
+    itemName?: string;
+    itemNbt?: string;
+    quantity?: number;
+    timeout?: number;
+}
+interface PublicStorageSourceEntity {
+    id: string;
+    name: string;
+    type: string;
+    alias?: string;
+}
+interface PublicStorageTransferRequest {
+    itemName: string;
+    itemNbt?: string;
+    quantity: number;
+    timeout?: number;
+    source?: string;
+    colors?: [number, number, number];
+}
+interface PublicStorageTransferResponse {
+    transfer: Transfer;
+    sourceEntity: PublicStorageSourceEntity;
+}
+interface ReportRecords<TRecord = unknown> {
     count: number;
-    total: number;
-    logs: ItemChangeLog[];
+    records: TRecord[];
 }
-interface PriceChangeLogResponse {
+interface ChangeLogResult<TLog = unknown> {
     count: number;
     total: number;
-    logs: PriceChangeLog[];
+    logs: TLog[];
 }
+type ShopChangeLogResponse = ChangeLogResult<ShopChangeLog>;
+type ItemChangeLogResponse = ChangeLogResult<ItemChangeLog>;
+type PriceChangeLogResponse = ChangeLogResult<PriceChangeLog>;
 interface ChangeLogOptions {
     limit?: number;
     offset?: number;
@@ -325,6 +474,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;
@@ -405,7 +577,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;
     }>;
@@ -414,21 +586,15 @@ 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>;
+    }): 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>;
@@ -451,6 +617,18 @@ declare class ApiKeyResource {
     redeemQuickCode(code: string): Promise<QuickCodeRedeemResponse>;
 }
 
+declare class TransfersResource {
+    private client;
+    constructor(client: HttpClient);
+    getAll(): Promise<Transfer[]>;
+    create(data: TransferCreateRequest): Promise<Transfer>;
+    get(transferId: string): Promise<Transfer>;
+    cancel(transferId: string): Promise<Transfer>;
+    getContents(): Promise<StorageSlotContents>;
+    getTargets(): Promise<TransferTarget[]>;
+    requestPublicStorage(data: PublicStorageTransferRequest): Promise<PublicStorageTransferResponse>;
+}
+
 interface KrawletClientConfig {
     baseUrl?: string;
     apiKey?: string;
@@ -470,6 +648,7 @@ declare class KrawletClient {
     readonly storage: StorageResource;
     readonly reports: ReportsResource;
     readonly apiKey: ApiKeyResource;
+    readonly transfers: TransfersResource;
     constructor(config?: KrawletClientConfig);
     getRateLimit(): RateLimit | undefined;
 }
@@ -486,4 +665,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 ItemChangeLogResponse, type ItemChangeType, ItemsResource, type KnownAddress, type KnownAddressType, KrawletClient, type KrawletClientConfig, KrawletError, type KromerServiceInfo, type Player, type PlayerNotifications, PlayersResource, type Price, type PriceChangeLog, type PriceChangeLogResponse, type QuickCodeGenerateResponse, type QuickCodeRedeemResponse, type RateLimit, type ReportRecords, ReportsResource, type RequestLog, type RequestLogsResponse, type ServiceInfo, type ServiceName, type ServiceStatus, type Shop, type ShopChangeLog, type ShopChangeLogResponse, 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 PublicStorageSourceEntity, type PublicStorageTransferRequest, type PublicStorageTransferResponse, 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 StorageSlotContents, type StorageSlotItem, type SuccessfulPostRecord, type Transfer, type TransferCreateRequest, type TransferStatus, type TransferTarget, type TransferTargetLink, TransfersResource, 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,34 +350,123 @@ 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 StorageSlotItem {
+    name: string;
     count: number;
-    records: unknown[];
+    nbt?: string | null;
 }
-interface ChangeLogResult {
-    count: number;
-    total: number;
-    logs: unknown[];
+interface StorageSlotContents {
+    items: StorageSlotItem[];
 }
-interface ShopChangeLogResponse {
-    count: number;
-    total: number;
-    logs: ShopChangeLog[];
+interface TransferTargetLink {
+    type: string;
+    value: string;
 }
-interface ItemChangeLogResponse {
+interface TransferTarget {
+    id: string;
+    name: string;
+    type: string;
+    links: TransferTargetLink[];
+}
+type TransferStatus = 'pending' | 'in_progress' | 'completed' | 'failed' | 'cancelled';
+interface Transfer {
+    id: string;
+    status: TransferStatus;
+    error: string | null;
+    workerId?: number | null;
+    fromUUID: string;
+    fromUsername: string;
+    toUUID: string;
+    toUsername: string;
+    itemName: string | null;
+    itemNbt: string | null;
+    quantity: number | null;
+    quantityTransferred: number;
+    timestamp: string;
+}
+interface TransferCreateRequest {
+    to: string;
+    itemName?: string;
+    itemNbt?: string;
+    quantity?: number;
+    timeout?: number;
+}
+interface PublicStorageSourceEntity {
+    id: string;
+    name: string;
+    type: string;
+    alias?: string;
+}
+interface PublicStorageTransferRequest {
+    itemName: string;
+    itemNbt?: string;
+    quantity: number;
+    timeout?: number;
+    source?: string;
+    colors?: [number, number, number];
+}
+interface PublicStorageTransferResponse {
+    transfer: Transfer;
+    sourceEntity: PublicStorageSourceEntity;
+}
+interface ReportRecords<TRecord = unknown> {
     count: number;
-    total: number;
-    logs: ItemChangeLog[];
+    records: TRecord[];
 }
-interface PriceChangeLogResponse {
+interface ChangeLogResult<TLog = unknown> {
     count: number;
     total: number;
-    logs: PriceChangeLog[];
+    logs: TLog[];
 }
+type ShopChangeLogResponse = ChangeLogResult<ShopChangeLog>;
+type ItemChangeLogResponse = ChangeLogResult<ItemChangeLog>;
+type PriceChangeLogResponse = ChangeLogResult<PriceChangeLog>;
 interface ChangeLogOptions {
     limit?: number;
     offset?: number;
@@ -325,6 +474,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;
@@ -405,7 +577,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;
     }>;
@@ -414,21 +586,15 @@ 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>;
+    }): 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>;
@@ -451,6 +617,18 @@ declare class ApiKeyResource {
     redeemQuickCode(code: string): Promise<QuickCodeRedeemResponse>;
 }
 
+declare class TransfersResource {
+    private client;
+    constructor(client: HttpClient);
+    getAll(): Promise<Transfer[]>;
+    create(data: TransferCreateRequest): Promise<Transfer>;
+    get(transferId: string): Promise<Transfer>;
+    cancel(transferId: string): Promise<Transfer>;
+    getContents(): Promise<StorageSlotContents>;
+    getTargets(): Promise<TransferTarget[]>;
+    requestPublicStorage(data: PublicStorageTransferRequest): Promise<PublicStorageTransferResponse>;
+}
+
 interface KrawletClientConfig {
     baseUrl?: string;
     apiKey?: string;
@@ -470,6 +648,7 @@ declare class KrawletClient {
     readonly storage: StorageResource;
     readonly reports: ReportsResource;
     readonly apiKey: ApiKeyResource;
+    readonly transfers: TransfersResource;
     constructor(config?: KrawletClientConfig);
     getRateLimit(): RateLimit | undefined;
 }
@@ -486,4 +665,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 ItemChangeLogResponse, type ItemChangeType, ItemsResource, type KnownAddress, type KnownAddressType, KrawletClient, type KrawletClientConfig, KrawletError, type KromerServiceInfo, type Player, type PlayerNotifications, PlayersResource, type Price, type PriceChangeLog, type PriceChangeLogResponse, type QuickCodeGenerateResponse, type QuickCodeRedeemResponse, type RateLimit, type ReportRecords, ReportsResource, type RequestLog, type RequestLogsResponse, type ServiceInfo, type ServiceName, type ServiceStatus, type Shop, type ShopChangeLog, type ShopChangeLogResponse, 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 PublicStorageSourceEntity, type PublicStorageTransferRequest, type PublicStorageTransferResponse, 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 StorageSlotContents, type StorageSlotItem, type SuccessfulPostRecord, type Transfer, type TransferCreateRequest, type TransferStatus, type TransferTarget, type TransferTargetLink, TransfersResource, 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,12 +485,19 @@ 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;
   }
   /**
@@ -487,15 +506,18 @@ var ReportsResource = class {
    * @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;
   }
   /**
@@ -504,15 +526,18 @@ var ReportsResource = class {
    * @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;
   }
   /**
@@ -521,15 +546,18 @@ var ReportsResource = class {
    * @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;
   }
   /**
@@ -685,6 +713,84 @@ var ApiKeyResource = class {
   }
 };
 
+// src/resources/transfers.ts
+var TransfersResource = class {
+  constructor(client) {
+    this.client = client;
+  }
+  /**
+   * List all transfers where the authenticated player is sender or recipient
+   * @returns Array of transfer records
+   */
+  async getAll() {
+    const response = await this.client.request("/v1/transfers");
+    return response.data;
+  }
+  /**
+   * Queue a new transfer request
+   * @param data - Transfer request payload
+   * @returns Transfer record
+   */
+  async create(data) {
+    const response = await this.client.request("/v1/transfers", {
+      method: "POST",
+      body: data
+    });
+    return response.data;
+  }
+  /**
+   * Retrieve transfer details by ID
+   * @param transferId - Transfer UUID
+   * @returns Transfer record
+   */
+  async get(transferId) {
+    const response = await this.client.request(`/v1/transfers/${transferId}`);
+    return response.data;
+  }
+  /**
+   * Cancel a pending or in-progress transfer
+   * @param transferId - Transfer UUID
+   * @returns Updated transfer record
+   */
+  async cancel(transferId) {
+    const response = await this.client.request(`/v1/transfers/${transferId}/cancel`, {
+      method: "POST"
+    });
+    return response.data;
+  }
+  /**
+   * Get current ender storage contents for the authenticated player
+   * @returns Contents snapshot
+   */
+  async getContents() {
+    const response = await this.client.request("/v1/transfers/contents");
+    return response.data;
+  }
+  /**
+   * List active transfer targets available to the authenticated user
+   * @returns Array of transfer targets
+   */
+  async getTargets() {
+    const response = await this.client.request("/v1/transfers/targets");
+    return response.data;
+  }
+  /**
+   * Request transfer from public/service storage into the authenticated player's storage
+   * @param data - Public storage transfer payload
+   * @returns Transfer and resolved source entity information
+   */
+  async requestPublicStorage(data) {
+    const response = await this.client.request(
+      "/v1/requests/public-storage",
+      {
+        method: "POST",
+        body: data
+      }
+    );
+    return response.data;
+  }
+};
+
 // src/client.ts
 var KrawletClient = class {
   /**
@@ -710,6 +816,7 @@ var KrawletClient = class {
     this.storage = new StorageResource(this.httpClient);
     this.reports = new ReportsResource(this.httpClient);
     this.apiKey = new ApiKeyResource(this.httpClient);
+    this.transfers = new TransfersResource(this.httpClient);
   }
   /**
    * Get the last known rate limit information
@@ -748,5 +855,6 @@ export {
   PlayersResource,
   ReportsResource,
   ShopsResource,
-  StorageResource
+  StorageResource,
+  TransfersResource
 };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "krawlet-js",
-  "version": "1.3.5",
+  "version": "2.1.0",
   "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",