mindupload 1.5.1

package/dist/index.js

@@ -0,0 +1,443 @@
+// src/errors.ts
+var MindUploadError = class extends Error {
+  operation;
+  response;
+  constructor(message, options = {}) {
+    super(message);
+    this.name = "MindUploadError";
+    this.operation = options.operation;
+    this.response = options.response;
+    Object.setPrototypeOf(this, new.target.prototype);
+  }
+};
+var ApiError = class extends MindUploadError {
+  status;
+  constructor(message, options) {
+    super(message, options);
+    this.name = "ApiError";
+    this.status = options.status;
+  }
+};
+var AuthenticationError = class extends ApiError {
+  constructor(message, options) {
+    super(message, options);
+    this.name = "AuthenticationError";
+  }
+};
+var RateLimitError = class extends ApiError {
+  /** Server-advised wait in seconds, when provided. */
+  retryAfter;
+  constructor(message, options) {
+    super(message, options);
+    this.name = "RateLimitError";
+    this.retryAfter = options.retryAfter;
+  }
+};
+var MindUploadConnectionError = class extends MindUploadError {
+  constructor(message, options = {}) {
+    super(message, options);
+    this.name = "MindUploadConnectionError";
+  }
+};
+
+// src/version.ts
+var VERSION = "1.5.1";
+
+// src/client.ts
+var DEFAULT_BASE_URL = "https://partner.mindupload.app";
+var AUTH_HEADER = "X-Partner-Key";
+var RETRY_STATUSES = /* @__PURE__ */ new Set([429, 503]);
+function camelToSnake(key) {
+  return key.replace(/[A-Z]/g, (m) => "_" + m.toLowerCase());
+}
+function toBody(params) {
+  const out = {};
+  for (const [key, value] of Object.entries(params)) {
+    if (value !== void 0 && value !== null) out[camelToSnake(key)] = value;
+  }
+  return out;
+}
+function sleep(ms) {
+  return new Promise((resolve) => setTimeout(resolve, ms));
+}
+function backoffMs(attempt, retryAfter) {
+  if (retryAfter) {
+    const seconds = Number(retryAfter);
+    if (Number.isFinite(seconds)) return Math.min(seconds * 1e3, 6e4);
+  }
+  return Math.min(500 * 2 ** (attempt - 1), 8e3);
+}
+var MindUploadBase = class {
+  partnerKey;
+  baseUrl;
+  preferredLanguage;
+  timeoutMs;
+  maxRetries;
+  userAgent;
+  fetchFn;
+  constructor(options) {
+    if (!options || !options.partnerKey) {
+      throw new Error(
+        "partnerKey is required. It is a server-side secret \u2014 never expose it to a browser or ship it in client code."
+      );
+    }
+    this.partnerKey = options.partnerKey;
+    this.baseUrl = (options.baseUrl ?? DEFAULT_BASE_URL).replace(/\/+$/, "");
+    this.preferredLanguage = options.preferredLanguage;
+    this.timeoutMs = options.timeoutMs ?? 3e4;
+    this.maxRetries = options.maxRetries ?? 2;
+    this.userAgent = options.userAgent ?? `mindupload-js/${VERSION}`;
+    const globalFetch = globalThis.fetch;
+    if (!globalFetch) {
+      throw new Error("global fetch is not available; use Node 18+, Deno, Bun, or an edge runtime.");
+    }
+    this.fetchFn = globalFetch.bind(globalThis);
+  }
+  async request(operation, params) {
+    const body = toBody(params);
+    if (body["preferred_language"] === void 0 && this.preferredLanguage !== void 0) {
+      body["preferred_language"] = this.preferredLanguage;
+    }
+    const url = `${this.baseUrl}/v1/${operation}`;
+    const payload = JSON.stringify(body);
+    const headers = {
+      "Content-Type": "application/json",
+      Accept: "application/json",
+      [AUTH_HEADER]: this.partnerKey,
+      "User-Agent": this.userAgent
+    };
+    let attempt = 0;
+    for (; ; ) {
+      let response;
+      try {
+        response = await this.fetchFn(url, { method: "POST", headers, body: payload, signal: this.timeoutSignal() });
+      } catch (err) {
+        throw new MindUploadConnectionError(
+          `Could not reach the Mind Upload API for '${operation}': ${err.message}`,
+          { operation }
+        );
+      }
+      let text;
+      try {
+        text = await response.text();
+      } catch (err) {
+        throw new MindUploadConnectionError(
+          `Failed to read the Mind Upload API response for '${operation}': ${err.message}`,
+          { operation }
+        );
+      }
+      let data;
+      try {
+        data = text ? JSON.parse(text) : { success: false };
+      } catch {
+        data = { success: false };
+      }
+      if (!response.ok) {
+        if (RETRY_STATUSES.has(response.status) && attempt < this.maxRetries) {
+          attempt += 1;
+          await sleep(backoffMs(attempt, response.headers.get("Retry-After")));
+          continue;
+        }
+        throw this.errorFor(response.status, data, operation, response.headers.get("Retry-After"));
+      }
+      if (!data.success) {
+        throw new MindUploadError(data.error_message || `${operation} failed`, { operation, response: data });
+      }
+      return data;
+    }
+  }
+  timeoutSignal() {
+    const abortSignal = globalThis.AbortSignal;
+    return abortSignal && typeof abortSignal.timeout === "function" ? abortSignal.timeout(this.timeoutMs) : void 0;
+  }
+  errorFor(status, data, operation, retryAfterHeader) {
+    const message = data && data.error_message || `HTTP ${status}`;
+    if (status === 401) return new AuthenticationError(message, { status, operation, response: data });
+    if (status === 429) {
+      const parsed = retryAfterHeader ? Number(retryAfterHeader) : void 0;
+      const retryAfter = parsed !== void 0 && Number.isFinite(parsed) ? parsed : void 0;
+      return new RateLimitError(message, { status, operation, response: data, retryAfter });
+    }
+    return new ApiError(message, { status, operation, response: data });
+  }
+};
+
+// src/operations.ts
+var MindUpload = class extends MindUploadBase {
+  // --- AI Consciousnesses ---
+  /** Create a new AI consciousness for the user.
+   *
+   * Response fields: success, error_message.
+   * @see https://docs.mindupload.app
+   */
+  createClone(params = {}) {
+    return this.request("create_clone", params);
+  }
+  /** List the user's AI consciousnesses.
+   *
+   * Response fields: success, error_message, clones.
+   * @see https://docs.mindupload.app
+   */
+  getClones(params = {}) {
+    return this.request("get_clones", params);
+  }
+  /** Update an AI consciousness's profile.
+   *
+   * Response fields: success, error_message.
+   * @see https://docs.mindupload.app
+   */
+  updateClone(params = {}) {
+    return this.request("update_clone", params);
+  }
+  // --- Account ---
+  /** Check your partner API rate limits, credit caps, and current usage.
+   *
+   * Response fields: success, error_message, per_user_rate_limit_per_min, per_user_daily_credit_cap, partner_rate_limit_per_min, partner_daily_credit_cap, max_users, registered_users, partner_requests_last_minute, partner_credit_spends_last_day, user, user_requests_last_minute, user_credit_spends_last_day, credit_spending_tasks, operation_duration_ms.
+   * @see https://docs.mindupload.app
+   */
+  getQuota(params = {}) {
+    return this.request("get_quota", params);
+  }
+  // --- Authentication ---
+  /** Check whether a username is still available before registering.
+   *
+   * Response fields: success, error_message, exists, disabled, rate_limited, flood_window, wait_seconds, operation_duration_ms.
+   * @see https://docs.mindupload.app
+   */
+  checkUsername(params = {}) {
+    return this.request("check_username", params);
+  }
+  /** Sign a user in and receive a session token (JWT) for subsequent calls.
+   *
+   * Response fields: success, error_message, jwt, decrypted_user.
+   * @see https://docs.mindupload.app
+   */
+  login(params = {}) {
+    return this.request("login", params);
+  }
+  /** End the current user session.
+   *
+   * Response fields: success, error_message, revoked, operation_duration_ms.
+   * @see https://docs.mindupload.app
+   */
+  logout(params = {}) {
+    return this.request("logout", params);
+  }
+  /** Create a user account on your platform.
+   *
+   * Response fields: success, error_message, jwt, decrypted_user.
+   * @see https://docs.mindupload.app
+   */
+  register(params = {}) {
+    return this.request("register", params);
+  }
+  // --- Chatrooms ---
+  /** Cheaply poll whether the user's chatrooms have new activity.
+   *
+   * Response fields: success, error_message, server_time, poll_config, chatrooms.
+   * @see https://docs.mindupload.app
+   */
+  checkChatroomUpdates(params = {}) {
+    return this.request("check_chatroom_updates", params);
+  }
+  /** Create a chatroom.
+   *
+   * Response fields: success, error_message, chatroom_id.
+   * @see https://docs.mindupload.app
+   */
+  createChatroom(params = {}) {
+    return this.request("create_chatroom", params);
+  }
+  /** Invite a user or an AI consciousness into a chatroom.
+   *
+   * Response fields: success, error_message, membership_id.
+   * @see https://docs.mindupload.app
+   */
+  createChatroomMembership(params = {}) {
+    return this.request("create_chatroom_membership", params);
+  }
+  /** Send a message to a chatroom.
+   *
+   * Response fields: success, error_message, message_id.
+   * @see https://docs.mindupload.app
+   */
+  createChatroomMessage(params = {}) {
+    return this.request("create_chatroom_message", params);
+  }
+  /** List the members of a chatroom the user belongs to.
+   *
+   * Response fields: success, error_message, total_count, page, page_size, total_pages, has_next, has_prev, next_cursor_value, next_cursor_id, memberships.
+   * @see https://docs.mindupload.app
+   */
+  getChatroomMembership(params = {}) {
+    return this.request("get_chatroom_membership", params);
+  }
+  /** Fetch messages from a chatroom the user belongs to.
+   *
+   * Response fields: success, error_message, total_count, page, page_size, total_pages, has_next, has_prev, next_cursor_value, next_cursor_id, messages, media_thumbnails, since_overflow.
+   * @see https://docs.mindupload.app
+   */
+  getChatroomMessages(params = {}) {
+    return this.request("get_chatroom_messages", params);
+  }
+  /** List the chatrooms the user belongs to.
+   *
+   * Response fields: success, error_message, total_count, page, page_size, total_pages, has_next, has_prev, next_cursor_value, next_cursor_id, chatrooms.
+   * @see https://docs.mindupload.app
+   */
+  getChatrooms(params = {}) {
+    return this.request("get_chatrooms", params);
+  }
+  // --- Conversation ---
+  /** Fetch the one-on-one conversation history with an AI consciousness.
+   *
+   * Response fields: success, error_message, total_count, page, page_size, total_pages, has_next, has_prev, next_cursor_value, next_cursor_id, chats, media_thumbnails.
+   * @see https://docs.mindupload.app
+   */
+  getChat(params = {}) {
+    return this.request("get_chat", params);
+  }
+  /** Send a message to an AI consciousness and receive its reply.
+   *
+   * Response fields: success, error_message, response_text, clone_nickname, consolidation_summary, consolidation_count, consolidation_dispatched.
+   * @see https://docs.mindupload.app
+   */
+  rag(params = {}) {
+    return this.request("rag", params);
+  }
+  /** Have an AI consciousness proactively join the conversation in a chatroom.
+   *
+   * Response fields: success, error_message, response_text, chatroom_digests_count, chatroom_digests_summary, consolidation_summary, consolidation_count, consolidation_dispatched.
+   * @see https://docs.mindupload.app
+   */
+  triggerSocial(params = {}) {
+    return this.request("trigger_social", params);
+  }
+  // --- Insights ---
+  /** Fetch the mind-graph visualization data of an AI consciousness.
+   *
+   * Response fields: success, error_message, root_node_id, node, children, texts, total_texts, texts_offset, has_more_texts, is_building.
+   * @see https://docs.mindupload.app
+   */
+  getMindCluster(params = {}) {
+    return this.request("get_mind_cluster", params);
+  }
+  /** Generate or fetch the compatibility report between two chatroom members.
+   *
+   * Response fields: success, error_message, report, report_generated_at, is_generating, charged.
+   * @see https://docs.mindupload.app
+   */
+  getSoulmateReport(params = {}) {
+    return this.request("get_soulmate_report", params);
+  }
+  // --- Media ---
+  /** Cancel a multipart upload and discard its parts.
+   *
+   * Response fields: success, error_message.
+   * @see https://docs.mindupload.app
+   */
+  abortMultipartUpload(params = {}) {
+    return this.request("abort_multipart_upload", params);
+  }
+  /** Cancel a pending upload.
+   *
+   * Response fields: success, error_message.
+   * @see https://docs.mindupload.app
+   */
+  cancelUpload(params = {}) {
+    return this.request("cancel_upload", params);
+  }
+  /** Finish a multipart upload.
+   *
+   * Response fields: success, error_message, media_url.
+   * @see https://docs.mindupload.app
+   */
+  completeMultipartUpload(params = {}) {
+    return this.request("complete_multipart_upload", params);
+  }
+  /** List the parts already uploaded in a multipart upload.
+   *
+   * Response fields: success, error_message, parts.
+   * @see https://docs.mindupload.app
+   */
+  listUploadParts(params = {}) {
+    return this.request("list_upload_parts", params);
+  }
+  /** Start a large-file upload in multiple parts.
+   *
+   * Response fields: success, error_message, upload_id, r2_key, media_url, signed_media_url, thumbnail_r2_key, thumbnail_presigned_url, signed_thumbnail_url, message.
+   * @see https://docs.mindupload.app
+   */
+  requestMultipartUpload(params = {}) {
+    return this.request("request_multipart_upload", params);
+  }
+  /** Request an upload slot and a signed viewing link for a media attachment.
+   *
+   * Response fields: success, error_message, r2_key, presigned_url, media_url, signed_media_url, thumbnail_r2_key, thumbnail_presigned_url, signed_thumbnail_url, message.
+   * @see https://docs.mindupload.app
+   */
+  requestUploadUrl(params = {}) {
+    return this.request("request_upload_url", params);
+  }
+  /** Get the signed link for one part of a multipart upload.
+   *
+   * Response fields: success, error_message, presigned_url.
+   * @see https://docs.mindupload.app
+   */
+  signUploadPart(params = {}) {
+    return this.request("sign_upload_part", params);
+  }
+  /** Get signed links for several parts of a multipart upload at once.
+   *
+   * Response fields: success, error_message, presigned_urls.
+   * @see https://docs.mindupload.app
+   */
+  signUploadPartsBatch(params = {}) {
+    return this.request("sign_upload_parts_batch", params);
+  }
+  // --- Memories ---
+  /** Upload a memory or persona entry to an AI consciousness.
+   *
+   * Response fields: success, error_message, cluster_label, cluster_modified_count.
+   * @see https://docs.mindupload.app
+   */
+  createText(params = {}) {
+    return this.request("create_text", params);
+  }
+  /** List the memories and persona entries uploaded to an AI consciousness.
+   *
+   * Response fields: success, error_message, total_count, page, page_size, total_pages, has_next, has_prev, next_cursor_value, next_cursor_id, texts.
+   * @see https://docs.mindupload.app
+   */
+  getTexts(params = {}) {
+    return this.request("get_texts", params);
+  }
+  // --- Users ---
+  /** Fetch the signed-in user's profile.
+   *
+   * Response fields: success, error_message, jwt, decrypted_user.
+   * @see https://docs.mindupload.app
+   */
+  getUser(params = {}) {
+    return this.request("get_user", params);
+  }
+  /** Update the signed-in user's profile.
+   *
+   * Response fields: success, error_message.
+   * @see https://docs.mindupload.app
+   */
+  updateUser(params = {}) {
+    return this.request("update_user", params);
+  }
+};
+export {
+  ApiError,
+  AuthenticationError,
+  DEFAULT_BASE_URL,
+  MindUpload,
+  MindUploadBase,
+  MindUploadConnectionError,
+  MindUploadError,
+  RateLimitError,
+  VERSION
+};

package/package.json

@@ -0,0 +1,64 @@
+{
+  "name": "mindupload",
+  "version": "1.5.1",
+  "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",
+    "mind upload",
+    "AI consciousness",
+    "artificial consciousness",
+    "digital consciousness",
+    "AI clone",
+    "AI persona",
+    "AI companion",
+    "AI chatroom",
+    "digital immortality",
+    "consciousness API",
+    "AI SDK"
+  ],
+  "license": "MIT",
+  "author": "Mind Upload",
+  "homepage": "https://docs.mindupload.app",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/Voidborn-Industries/mindupload-sdk-js.git"
+  },
+  "bugs": {
+    "url": "https://docs.mindupload.app"
+  },
+  "type": "module",
+  "main": "./dist/index.cjs",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "import": {
+        "types": "./dist/index.d.ts",
+        "default": "./dist/index.js"
+      },
+      "require": {
+        "types": "./dist/index.d.cts",
+        "default": "./dist/index.cjs"
+      }
+    }
+  },
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE"
+  ],
+  "engines": {
+    "node": ">=18"
+  },
+  "sideEffects": false,
+  "scripts": {
+    "build": "tsup src/index.ts --format esm,cjs --dts --clean --target node18",
+    "test": "node --test",
+    "prepublishOnly": "npm run build"
+  },
+  "devDependencies": {
+    "tsup": "^8.0.0",
+    "typescript": "^5.4.0",
+    "@types/node": "^20.0.0"
+  }
+}