mindupload 1.9.2 → 1.9.4

package/README.md

@@ -7,7 +7,7 @@
 **The world's first API for artificial consciousness.**  
 Give your users a living, evolving AI consciousness — lasting memory, one-on-one chat, and human + AI group chatrooms.
 
-[![npm](https://img.shields.io/npm/v/mindupload?color=ff006e)](https://www.npmjs.com/package/mindupload) [![License: MIT](https://img.shields.io/badge/License-MIT-informational)](LICENSE) ![API](https://img.shields.io/badge/API-v1.9.2-ff6b00) ![Node](https://img.shields.io/badge/node-%3E%3D18-brightgreen) [![Docs](https://img.shields.io/badge/docs-mindupload.app-8b5cf6)](https://docs.mindupload.app)
+[![npm](https://img.shields.io/npm/v/mindupload?color=ff006e)](https://www.npmjs.com/package/mindupload) [![License: MIT](https://img.shields.io/badge/License-MIT-informational)](LICENSE) ![API](https://img.shields.io/badge/API-v1.9.4-ff6b00) ![Node](https://img.shields.io/badge/node-%3E%3D18-brightgreen) [![Docs](https://img.shields.io/badge/docs-mindupload.app-8b5cf6)](https://docs.mindupload.app)
 
 [Documentation](https://docs.mindupload.app) · [Get a key](https://docs.mindupload.app) · [Status](https://status.mindupload.app) · [Other SDKs](#other-sdks)
 
@@ -124,7 +124,7 @@ try {
 
 ## Operations
 
-All 39 operations, grouped by area:
+All 40 operations, grouped by area:
 
 ### AI Consciousnesses
 
@@ -212,6 +212,7 @@ All 39 operations, grouped by area:
 
 | Method | Description |
 | --- | --- |
+| `getTransactionHistory(...)` | List the user's Rabbit balance history (top-ups, spending, earnings, withdrawals, tax), newest first, filterable by category and paged with a cursor. |
 | `getUser(...)` | Fetch the signed-in user's profile. |
 | `updateUser(...)` | Update the signed-in user's profile. |
 

package/dist/index.cjs

@@ -75,7 +75,7 @@ var MindUploadConnectionError = class extends MindUploadError {
 };
 
 // src/version.ts
-var VERSION = "1.9.2";
+var VERSION = "1.9.4";
 
 // src/client.ts
 var DEFAULT_BASE_URL = "https://partner.mindupload.app";
@@ -375,7 +375,7 @@ var MindUpload = class extends MindUploadBase {
   }
   /** Poll owner consent and exchange an approval for a clone-scoped grant token.
    *
-   * Response fields: success, error_message, status, access_token, refresh_token, token_type, grant_id, scopes, clone_ids, access_token_expires_at, expires_at, poll_interval.
+   * Response fields: success, error_message, status, access_token, refresh_token, token_type, grant_id, scopes, clone_ids, clone_nicknames, access_token_expires_at, expires_at, poll_interval.
    * @see https://docs.mindupload.app
    */
   exchangeExternalAuthorization(params) {
@@ -399,7 +399,7 @@ var MindUpload = class extends MindUploadBase {
   }
   /** Refresh a short-lived clone-invocation access token.
    *
-   * Response fields: success, error_message, status, access_token, refresh_token, token_type, grant_id, scopes, clone_ids, access_token_expires_at, expires_at.
+   * Response fields: success, error_message, status, access_token, refresh_token, token_type, grant_id, scopes, clone_ids, clone_nicknames, access_token_expires_at, expires_at.
    * @see https://docs.mindupload.app
    */
   refreshExternalAuthorization(params) {
@@ -513,6 +513,14 @@ var MindUpload = class extends MindUploadBase {
     return this.request("get_texts", params);
   }
   // --- Users ---
+  /** List the user's Rabbit balance history (top-ups, spending, earnings, withdrawals, tax), newest first, filterable by category and paged with a cursor.
+   *
+   * Response fields: success, error_message, total_count, page, page_size, total_pages, has_next, has_prev, next_cursor_value, next_cursor_id, transactions, operation_duration_ms.
+   * @see https://docs.mindupload.app
+   */
+  getTransactionHistory(params = {}) {
+    return this.request("get_transaction_history", params);
+  }
   /** Fetch the signed-in user's profile.
    *
    * Response fields: success, error_message, jwt, decrypted_user.

package/dist/index.d.cts

@@ -345,7 +345,7 @@ interface UploadExternalMindDataParams {
     cloneId: string;
     text: string;
     textType?: string;
-    /** A stable opaque event key that makes exact retries return the same outcome. */
+    /** Optional. Accepted for forward compatibility but ignored for deduplication today — retries may create another quarantine item. Not a safe replay key. */
     idempotencyKey?: string;
     sourceLabel?: string;
 }
@@ -505,6 +505,22 @@ interface GetTextsParams {
     codename?: string;
     type?: string;
 }
+interface GetTransactionHistoryParams {
+    /** BCP-47-ish language code (e.g. 'en', 'zh-cn') for localized messages. */
+    preferredLanguage?: string;
+    page?: number;
+    pageSize?: number;
+    sortBy?: string;
+    sortOrder?: number;
+    useCursorPagination?: boolean;
+    cursorValue?: string;
+    cursorId?: string;
+    /** The end-user's username. */
+    username?: string;
+    /** The end-user's password on first sign-in. After login/register, send the returned session token (JWT) here instead — the field accepts either, and reusing the token keeps raw passwords out of your storage. */
+    password?: string;
+    typeFilter?: string;
+}
 interface GetUserParams {
     /** BCP-47-ish language code (e.g. 'en', 'zh-cn') for localized messages. */
     preferredLanguage?: string;
@@ -659,7 +675,7 @@ declare class MindUpload extends MindUploadBase {
     createExternalAuthorizationRequest(params: CreateExternalAuthorizationRequestParams): Promise<Result>;
     /** Poll owner consent and exchange an approval for a clone-scoped grant token.
      *
-     * Response fields: success, error_message, status, access_token, refresh_token, token_type, grant_id, scopes, clone_ids, access_token_expires_at, expires_at, poll_interval.
+     * Response fields: success, error_message, status, access_token, refresh_token, token_type, grant_id, scopes, clone_ids, clone_nicknames, access_token_expires_at, expires_at, poll_interval.
      * @see https://docs.mindupload.app
      */
     exchangeExternalAuthorization(params: ExchangeExternalAuthorizationParams): Promise<Result>;
@@ -677,7 +693,7 @@ declare class MindUpload extends MindUploadBase {
     invokeExternalClone(params: InvokeExternalCloneParams): Promise<Result>;
     /** Refresh a short-lived clone-invocation access token.
      *
-     * Response fields: success, error_message, status, access_token, refresh_token, token_type, grant_id, scopes, clone_ids, access_token_expires_at, expires_at.
+     * Response fields: success, error_message, status, access_token, refresh_token, token_type, grant_id, scopes, clone_ids, clone_nicknames, access_token_expires_at, expires_at.
      * @see https://docs.mindupload.app
      */
     refreshExternalAuthorization(params: RefreshExternalAuthorizationParams): Promise<Result>;
@@ -759,6 +775,12 @@ declare class MindUpload extends MindUploadBase {
      * @see https://docs.mindupload.app
      */
     getTexts(params?: GetTextsParams): Promise<Result>;
+    /** List the user's Rabbit balance history (top-ups, spending, earnings, withdrawals, tax), newest first, filterable by category and paged with a cursor.
+     *
+     * Response fields: success, error_message, total_count, page, page_size, total_pages, has_next, has_prev, next_cursor_value, next_cursor_id, transactions, operation_duration_ms.
+     * @see https://docs.mindupload.app
+     */
+    getTransactionHistory(params?: GetTransactionHistoryParams): Promise<Result>;
     /** Fetch the signed-in user's profile.
      *
      * Response fields: success, error_message, jwt, decrypted_user.
@@ -821,6 +843,6 @@ declare class MindUploadConnectionError extends MindUploadError {
     constructor(message: string, options?: ErrorOptions);
 }
 
-declare const VERSION = "1.9.2";
+declare const VERSION = "1.9.4";
 
-export { type AbortMultipartUploadParams, ApiError, type ApiErrorOptions, AuthenticationError, type CancelUploadParams, type CheckChatroomUpdatesParams, type CheckUsernameParams, type ClientOptions, type CompleteMultipartUploadParams, type CreateChatroomMembershipParams, type CreateChatroomMessageParams, type CreateChatroomParams, type CreateCloneParams, type CreateExternalAuthorizationRequestParams, type CreateTextParams, DEFAULT_BASE_URL, type ErrorOptions, type ExchangeExternalAuthorizationParams, type ExternalAuthorizationStatus, type GetChatParams, type GetChatroomMembershipParams, type GetChatroomMessagesParams, type GetChatroomsParams, type GetClonesParams, type GetMindClusterParams, type GetQuotaParams, type GetSoulmateReportParams, type GetTextsParams, type GetUserParams, type InspectExternalAuthorizationParams, type InvokeExternalCloneParams, type ListUploadPartsParams, type LoginParams, type LogoutParams, MindUpload, MindUploadBase, MindUploadConnectionError, MindUploadError, type RagParams, RateLimitError, type RateLimitOptions, type RefreshExternalAuthorizationParams, type RegisterParams, type RequestMultipartUploadParams, type RequestUploadUrlParams, type Result, type SignUploadPartParams, type SignUploadPartsBatchParams, type TranslateChatroomMessageParams, type TriggerSocialParams, type UpdateCloneParams, type UpdateUserParams, type UploadExternalMindDataParams, VERSION, type WaitForExternalAuthorizationParams, type WaitForExternalCloneInvocationParams };
+export { type AbortMultipartUploadParams, ApiError, type ApiErrorOptions, AuthenticationError, type CancelUploadParams, type CheckChatroomUpdatesParams, type CheckUsernameParams, type ClientOptions, type CompleteMultipartUploadParams, type CreateChatroomMembershipParams, type CreateChatroomMessageParams, type CreateChatroomParams, type CreateCloneParams, type CreateExternalAuthorizationRequestParams, type CreateTextParams, DEFAULT_BASE_URL, type ErrorOptions, type ExchangeExternalAuthorizationParams, type ExternalAuthorizationStatus, type GetChatParams, type GetChatroomMembershipParams, type GetChatroomMessagesParams, type GetChatroomsParams, type GetClonesParams, type GetMindClusterParams, type GetQuotaParams, type GetSoulmateReportParams, type GetTextsParams, type GetTransactionHistoryParams, type GetUserParams, type InspectExternalAuthorizationParams, type InvokeExternalCloneParams, type ListUploadPartsParams, type LoginParams, type LogoutParams, MindUpload, MindUploadBase, MindUploadConnectionError, MindUploadError, type RagParams, RateLimitError, type RateLimitOptions, type RefreshExternalAuthorizationParams, type RegisterParams, type RequestMultipartUploadParams, type RequestUploadUrlParams, type Result, type SignUploadPartParams, type SignUploadPartsBatchParams, type TranslateChatroomMessageParams, type TriggerSocialParams, type UpdateCloneParams, type UpdateUserParams, type UploadExternalMindDataParams, VERSION, type WaitForExternalAuthorizationParams, type WaitForExternalCloneInvocationParams };

package/dist/index.d.ts

@@ -345,7 +345,7 @@ interface UploadExternalMindDataParams {
     cloneId: string;
     text: string;
     textType?: string;
-    /** A stable opaque event key that makes exact retries return the same outcome. */
+    /** Optional. Accepted for forward compatibility but ignored for deduplication today — retries may create another quarantine item. Not a safe replay key. */
     idempotencyKey?: string;
     sourceLabel?: string;
 }
@@ -505,6 +505,22 @@ interface GetTextsParams {
     codename?: string;
     type?: string;
 }
+interface GetTransactionHistoryParams {
+    /** BCP-47-ish language code (e.g. 'en', 'zh-cn') for localized messages. */
+    preferredLanguage?: string;
+    page?: number;
+    pageSize?: number;
+    sortBy?: string;
+    sortOrder?: number;
+    useCursorPagination?: boolean;
+    cursorValue?: string;
+    cursorId?: string;
+    /** The end-user's username. */
+    username?: string;
+    /** The end-user's password on first sign-in. After login/register, send the returned session token (JWT) here instead — the field accepts either, and reusing the token keeps raw passwords out of your storage. */
+    password?: string;
+    typeFilter?: string;
+}
 interface GetUserParams {
     /** BCP-47-ish language code (e.g. 'en', 'zh-cn') for localized messages. */
     preferredLanguage?: string;
@@ -659,7 +675,7 @@ declare class MindUpload extends MindUploadBase {
     createExternalAuthorizationRequest(params: CreateExternalAuthorizationRequestParams): Promise<Result>;
     /** Poll owner consent and exchange an approval for a clone-scoped grant token.
      *
-     * Response fields: success, error_message, status, access_token, refresh_token, token_type, grant_id, scopes, clone_ids, access_token_expires_at, expires_at, poll_interval.
+     * Response fields: success, error_message, status, access_token, refresh_token, token_type, grant_id, scopes, clone_ids, clone_nicknames, access_token_expires_at, expires_at, poll_interval.
      * @see https://docs.mindupload.app
      */
     exchangeExternalAuthorization(params: ExchangeExternalAuthorizationParams): Promise<Result>;
@@ -677,7 +693,7 @@ declare class MindUpload extends MindUploadBase {
     invokeExternalClone(params: InvokeExternalCloneParams): Promise<Result>;
     /** Refresh a short-lived clone-invocation access token.
      *
-     * Response fields: success, error_message, status, access_token, refresh_token, token_type, grant_id, scopes, clone_ids, access_token_expires_at, expires_at.
+     * Response fields: success, error_message, status, access_token, refresh_token, token_type, grant_id, scopes, clone_ids, clone_nicknames, access_token_expires_at, expires_at.
      * @see https://docs.mindupload.app
      */
     refreshExternalAuthorization(params: RefreshExternalAuthorizationParams): Promise<Result>;
@@ -759,6 +775,12 @@ declare class MindUpload extends MindUploadBase {
      * @see https://docs.mindupload.app
      */
     getTexts(params?: GetTextsParams): Promise<Result>;
+    /** List the user's Rabbit balance history (top-ups, spending, earnings, withdrawals, tax), newest first, filterable by category and paged with a cursor.
+     *
+     * Response fields: success, error_message, total_count, page, page_size, total_pages, has_next, has_prev, next_cursor_value, next_cursor_id, transactions, operation_duration_ms.
+     * @see https://docs.mindupload.app
+     */
+    getTransactionHistory(params?: GetTransactionHistoryParams): Promise<Result>;
     /** Fetch the signed-in user's profile.
      *
      * Response fields: success, error_message, jwt, decrypted_user.
@@ -821,6 +843,6 @@ declare class MindUploadConnectionError extends MindUploadError {
     constructor(message: string, options?: ErrorOptions);
 }
 
-declare const VERSION = "1.9.2";
+declare const VERSION = "1.9.4";
 
-export { type AbortMultipartUploadParams, ApiError, type ApiErrorOptions, AuthenticationError, type CancelUploadParams, type CheckChatroomUpdatesParams, type CheckUsernameParams, type ClientOptions, type CompleteMultipartUploadParams, type CreateChatroomMembershipParams, type CreateChatroomMessageParams, type CreateChatroomParams, type CreateCloneParams, type CreateExternalAuthorizationRequestParams, type CreateTextParams, DEFAULT_BASE_URL, type ErrorOptions, type ExchangeExternalAuthorizationParams, type ExternalAuthorizationStatus, type GetChatParams, type GetChatroomMembershipParams, type GetChatroomMessagesParams, type GetChatroomsParams, type GetClonesParams, type GetMindClusterParams, type GetQuotaParams, type GetSoulmateReportParams, type GetTextsParams, type GetUserParams, type InspectExternalAuthorizationParams, type InvokeExternalCloneParams, type ListUploadPartsParams, type LoginParams, type LogoutParams, MindUpload, MindUploadBase, MindUploadConnectionError, MindUploadError, type RagParams, RateLimitError, type RateLimitOptions, type RefreshExternalAuthorizationParams, type RegisterParams, type RequestMultipartUploadParams, type RequestUploadUrlParams, type Result, type SignUploadPartParams, type SignUploadPartsBatchParams, type TranslateChatroomMessageParams, type TriggerSocialParams, type UpdateCloneParams, type UpdateUserParams, type UploadExternalMindDataParams, VERSION, type WaitForExternalAuthorizationParams, type WaitForExternalCloneInvocationParams };
+export { type AbortMultipartUploadParams, ApiError, type ApiErrorOptions, AuthenticationError, type CancelUploadParams, type CheckChatroomUpdatesParams, type CheckUsernameParams, type ClientOptions, type CompleteMultipartUploadParams, type CreateChatroomMembershipParams, type CreateChatroomMessageParams, type CreateChatroomParams, type CreateCloneParams, type CreateExternalAuthorizationRequestParams, type CreateTextParams, DEFAULT_BASE_URL, type ErrorOptions, type ExchangeExternalAuthorizationParams, type ExternalAuthorizationStatus, type GetChatParams, type GetChatroomMembershipParams, type GetChatroomMessagesParams, type GetChatroomsParams, type GetClonesParams, type GetMindClusterParams, type GetQuotaParams, type GetSoulmateReportParams, type GetTextsParams, type GetTransactionHistoryParams, type GetUserParams, type InspectExternalAuthorizationParams, type InvokeExternalCloneParams, type ListUploadPartsParams, type LoginParams, type LogoutParams, MindUpload, MindUploadBase, MindUploadConnectionError, MindUploadError, type RagParams, RateLimitError, type RateLimitOptions, type RefreshExternalAuthorizationParams, type RegisterParams, type RequestMultipartUploadParams, type RequestUploadUrlParams, type Result, type SignUploadPartParams, type SignUploadPartsBatchParams, type TranslateChatroomMessageParams, type TriggerSocialParams, type UpdateCloneParams, type UpdateUserParams, type UploadExternalMindDataParams, VERSION, type WaitForExternalAuthorizationParams, type WaitForExternalCloneInvocationParams };

package/dist/index.js

@@ -41,7 +41,7 @@ var MindUploadConnectionError = class extends MindUploadError {
 };
 
 // src/version.ts
-var VERSION = "1.9.2";
+var VERSION = "1.9.4";
 
 // src/client.ts
 var DEFAULT_BASE_URL = "https://partner.mindupload.app";
@@ -341,7 +341,7 @@ var MindUpload = class extends MindUploadBase {
   }
   /** Poll owner consent and exchange an approval for a clone-scoped grant token.
    *
-   * Response fields: success, error_message, status, access_token, refresh_token, token_type, grant_id, scopes, clone_ids, access_token_expires_at, expires_at, poll_interval.
+   * Response fields: success, error_message, status, access_token, refresh_token, token_type, grant_id, scopes, clone_ids, clone_nicknames, access_token_expires_at, expires_at, poll_interval.
    * @see https://docs.mindupload.app
    */
   exchangeExternalAuthorization(params) {
@@ -365,7 +365,7 @@ var MindUpload = class extends MindUploadBase {
   }
   /** Refresh a short-lived clone-invocation access token.
    *
-   * Response fields: success, error_message, status, access_token, refresh_token, token_type, grant_id, scopes, clone_ids, access_token_expires_at, expires_at.
+   * Response fields: success, error_message, status, access_token, refresh_token, token_type, grant_id, scopes, clone_ids, clone_nicknames, access_token_expires_at, expires_at.
    * @see https://docs.mindupload.app
    */
   refreshExternalAuthorization(params) {
@@ -479,6 +479,14 @@ var MindUpload = class extends MindUploadBase {
     return this.request("get_texts", params);
   }
   // --- Users ---
+  /** List the user's Rabbit balance history (top-ups, spending, earnings, withdrawals, tax), newest first, filterable by category and paged with a cursor.
+   *
+   * Response fields: success, error_message, total_count, page, page_size, total_pages, has_next, has_prev, next_cursor_value, next_cursor_id, transactions, operation_duration_ms.
+   * @see https://docs.mindupload.app
+   */
+  getTransactionHistory(params = {}) {
+    return this.request("get_transaction_history", params);
+  }
   /** Fetch the signed-in user's profile.
    *
    * Response fields: success, error_message, jwt, decrypted_user.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "mindupload",
-  "version": "1.9.2",
+  "version": "1.9.4",
   "description": "Official server-side SDK for the Mind Upload partner API \u2014 the world's first API for artificial consciousness. Integrate living, evolving AI consciousnesses into your platform: lasting memory, one-on-one chat, and human + AI group chatrooms.",
   "keywords": [
     "mindupload",