simple_node_characterai 1.1.0

package/README.md

@@ -0,0 +1,79 @@
+# THIS PACKAGE HEAVILY INSPIRED BY [node_characterai](https://github.com/realcoloride/node_characterai/tree/2.0) PACKAGE.
+
+# Character AI (Node) Package
+
+Simple Node.js library for interacting with Character.AI via HTTP and WebSocket with typescript. It provides simple primitives to authenticate, create chats, send messages, and fetch chat turns. Perfect usage for route handlers in Node.js applications that need interactions with Character.AI in custom interface.
+
+## Features
+- Authenticate with a session token and initialize a WebSocket
+- Create one-on-one chats with characters
+- Send messages and await final replies
+- Fetch chat turns (messages) with pagination
+- Minimal, typed API with clear data models
+
+## Installation
+
+```bash
+npm install simple_node_characterai
+```
+
+## Quick Start
+
+```ts
+import { authenticate, createNewConversation, sendMessage, getMessages, getProfile } from 'simple_node_characterai';
+
+(async () => {
+  // 1) Authenticate with your session token (string without "Token " prefix is fine)
+  await authenticate('YOUR_SESSION_TOKEN');
+
+  // 2) Access the authenticated user profile
+  const profile = getProfile();
+  console.log('Logged in as:', profile.user.username);
+
+  // 3) Create a new chat with a character
+  const characterId = 'CHARACTER_ID';
+  const addTurn = await createNewConversation(characterId);
+  const chatId = addTurn.turn.turn_key.chat_id;
+
+  // 4) Send a message and wait for the final candidate
+  const response = await sendMessage('Hello!', characterId, chatId);
+  console.log(response.turn.candidates[0].raw_content);
+
+  // 5) Fetch latest turns (up to 50)
+  const turns = await getMessages(chatId);
+  console.log('Turns count:', turns.length);
+})();
+```
+
+## API Reference
+
+### Auth
+
+#### authenticate(sessionToken: string): Promise<void>
+- Authenticates the user, validates the token, loads the profile, and opens the WebSocket.
+- Accepts either raw token or `"Token XXX"` format.
+
+#### getProfile(): Profile
+- Returns the in-memory authenticated user profile.
+
+### Chat
+
+#### createNewConversation(characterId: string): Promise<AddTurnResponse>
+- Creates a new one-on-one chat with the specified character and resolves when the greeting turn arrives.
+- Returns metadata and the initial turn.
+
+#### sendMessage(message: string, characterId: string, chatId: string): Promise<UpdateTurnResponse>
+- Sends a user message to an existing chat.
+- Resolves when the model returns a final candidate for the turn.
+
+#### getMessages(chatId: string, token?: string): Promise<Turn[]>
+- Retrieves up to 50 turns for the given chat.
+- If a `token` is provided, fetches the next page of results using `next_token`.
+
+## Notes
+- This package is intended for personal use.
+- Avoid logging tokens, cookies, or PII; keep sensitive information in memory.
+- When building client-side applications, follow CORS restrictions; this package is designed for server-side Node usage.
+
+## Development
+Still in development but ready to use for basic chatting usage, more feature will be added in the future.

package/dist/Auth/index.d.ts

@@ -0,0 +1,14 @@
+import { type Profile } from "#types";
+/**
+ * Authenticates the user and initializes WebSocket connection.
+ * Validates the session token, loads user profile, and connects to chat.
+ * @param sessionToken - Character.AI session token (with or without "Token " prefix).
+ * @returns Resolves when authentication and connection complete.
+ */
+export declare const authenticate: (sessionToken: string) => Promise<void>;
+/**
+ * Returns the authenticated user's profile.
+ * @returns Profile object of the current user.
+ */
+export declare const getProfile: () => Profile;
+//# sourceMappingURL=index.d.ts.map

package/dist/Auth/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/Auth/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,OAAO,EAAE,MAAM,QAAQ,CAAC;AAMtC;;;;;GAKG;AACH,eAAO,MAAM,YAAY,GAAU,cAAc,MAAM,KAAI,OAAO,CAAC,IAAI,CAgBtE,CAAA;AAgBD;;;GAGG;AACH,eAAO,MAAM,UAAU,QAAQ,OAAe,CAAC"}

package/dist/Auth/index.js

@@ -0,0 +1,49 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getProfile = exports.authenticate = void 0;
+const Websocket_1 = require("../Websocket");
+const api_1 = require("../api");
+let user = {};
+/**
+ * Authenticates the user and initializes WebSocket connection.
+ * Validates the session token, loads user profile, and connects to chat.
+ * @param sessionToken - Character.AI session token (with or without "Token " prefix).
+ * @returns Resolves when authentication and connection complete.
+ */
+const authenticate = async (sessionToken) => {
+    if (sessionToken.startsWith("Token "))
+        sessionToken = sessionToken.substring("Token ".length, sessionToken.length);
+    (0, api_1.updateToken)(sessionToken);
+    const req = await (0, api_1.request)("https://plus.character.ai/chat/user/settings/", {
+        method: "GET",
+        includeAuthorization: true
+    });
+    if (!req.ok)
+        throw Error("Invaild authentication token.");
+    await loadProfile();
+    await (0, Websocket_1.connect)({
+        edgeRollout: "60",
+        authorization: sessionToken
+    });
+};
+exports.authenticate = authenticate;
+/**
+ * Loads the current user's profile into memory.
+ * Uses authorized request to fetch user details from Character.AI.
+ * @returns Resolves when the profile has been populated.
+ */
+const loadProfile = async () => {
+    const result = await (0, api_1.request)("https://plus.character.ai/chat/user/", {
+        method: 'GET',
+        includeAuthorization: true
+    });
+    const profile = await result.json();
+    Object.assign(user, profile.user);
+};
+/**
+ * Returns the authenticated user's profile.
+ * @returns Profile object of the current user.
+ */
+const getProfile = () => user;
+exports.getProfile = getProfile;
+//# sourceMappingURL=index.js.map

package/dist/Auth/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/Auth/index.ts"],"names":[],"mappings":";;;AACA,4CAAuC;AACvC,gCAA8C;AAE9C,IAAI,IAAI,GAAY,EAAa,CAAC;AAElC;;;;;GAKG;AACI,MAAM,YAAY,GAAG,KAAK,EAAE,YAAoB,EAAkB,EAAE;IACvE,IAAI,YAAY,CAAC,UAAU,CAAC,QAAQ,CAAC;QAAE,YAAY,GAAG,YAAY,CAAC,SAAS,CAAC,QAAQ,CAAC,MAAM,EAAE,YAAY,CAAC,MAAM,CAAC,CAAC;IAEnH,IAAA,iBAAW,EAAC,YAAY,CAAC,CAAC;IAE1B,MAAM,GAAG,GAAG,MAAM,IAAA,aAAO,EAAC,+CAA+C,EAAE;QACvE,MAAM,EAAE,KAAK;QACb,oBAAoB,EAAE,IAAI;KAC7B,CAAC,CAAC;IACH,IAAI,CAAC,GAAG,CAAC,EAAE;QAAE,MAAM,KAAK,CAAC,+BAA+B,CAAC,CAAC;IAE1D,MAAM,WAAW,EAAE,CAAC;IACpB,MAAM,IAAA,mBAAO,EAAC;QACV,WAAW,EAAE,IAAI;QACjB,aAAa,EAAE,YAAY;KAC9B,CAAC,CAAC;AACP,CAAC,CAAA;AAhBY,QAAA,YAAY,gBAgBxB;AAED;;;;GAIG;AACH,MAAM,WAAW,GAAG,KAAK,IAAoB,EAAE;IAC3C,MAAM,MAAM,GAAG,MAAM,IAAA,aAAO,EAAC,sCAAsC,EAAE;QACjE,MAAM,EAAE,KAAK;QACb,oBAAoB,EAAE,IAAI;KAC7B,CAAC,CAAC;IACH,MAAM,OAAO,GAAG,MAAM,MAAM,CAAC,IAAI,EAAE,CAAC;IACpC,MAAM,CAAC,MAAM,CAAC,IAAI,EAAE,OAAO,CAAC,IAAI,CAAC,CAAC;AACtC,CAAC,CAAA;AAED;;;GAGG;AACI,MAAM,UAAU,GAAG,GAAa,EAAE,CAAC,IAAI,CAAC;AAAlC,QAAA,UAAU,cAAwB"}

package/dist/Chat/Messages.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=Messages.d.ts.map

package/dist/Chat/Messages.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Messages.d.ts","sourceRoot":"","sources":["../../src/Chat/Messages.ts"],"names":[],"mappings":""}

package/dist/Chat/Messages.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=Messages.js.map

package/dist/Chat/Messages.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Messages.js","sourceRoot":"","sources":["../../src/Chat/Messages.ts"],"names":[],"mappings":""}

package/dist/Chat/index.d.ts

@@ -0,0 +1,26 @@
+import { AddTurnResponse, UpdateTurnResponse, Turn } from "../types/Chat";
+/**
+ * Creates a new one-on-one chat for the given character.
+ * Opens a WebSocket request and resolves when the initial turn is added.
+ * @param characterId - The ID of the character to start a chat with.
+ * @returns AddTurnResponse containing chat metadata and the greeting turn.
+ */
+export declare const createNewConversation: (characterId: string) => Promise<AddTurnResponse>;
+/**
+ * Sends a message to an existing chat and waits for the final reply.
+ * Uses the WebSocket to create and generate a turn, resolving on final candidate.
+ * @param message - The user's text message to send.
+ * @param characterId - The target character's ID.
+ * @param chatId - The ID of the chat where the message is posted.
+ * @returns UpdateTurnResponse containing the generated turn with final candidate.
+ */
+export declare const sendMessage: (message: string, characterId: string, chatId: string) => Promise<UpdateTurnResponse>;
+/**
+ * Retrieves up to 50 messages (turns) for a given chat.
+ * If a `token` is provided, it fetches the next page of results.
+ * @param chatId - The ID of the chat whose messages are to be fetched.
+ * @param token - Optional pagination token for retrieving the next batch.
+ * @return Parsed JSON containing up to 50 messages.
+ */
+export declare const getMessages: (chatId: string, token?: string) => Promise<Turn[]>;
+//# sourceMappingURL=index.d.ts.map

package/dist/Chat/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/Chat/index.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,eAAe,EAAmD,kBAAkB,EAAE,IAAI,EAAE,MAAM,eAAe,CAAC;AAK3H;;;;;GAKG;AACH,eAAO,MAAM,qBAAqB,GAAU,aAAa,MAAM,KAAG,OAAO,CAAC,eAAe,CA0CxF,CAAC;AAEF;;;;;;;GAOG;AACH,eAAO,MAAM,WAAW,GAAU,SAAS,MAAM,EAAE,aAAa,MAAM,EAAE,QAAQ,MAAM,KAAG,OAAO,CAAC,kBAAkB,CAqFlH,CAAC;AAEF;;;;;;GAMG;AACH,eAAO,MAAM,WAAW,GAAU,QAAQ,MAAM,EAAE,QAAQ,MAAM,KAAI,OAAO,CAAC,IAAI,EAAE,CAUjF,CAAA"}

package/dist/Chat/index.js

@@ -0,0 +1,176 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getMessages = exports.sendMessage = exports.createNewConversation = void 0;
+const EventBus_1 = __importDefault(require("../EventBus"));
+const Auth_1 = require("../Auth");
+const Websocket_1 = require("../Websocket");
+const uuid_1 = require("uuid");
+const api_1 = require("../api");
+/**
+ * Creates a new one-on-one chat for the given character.
+ * Opens a WebSocket request and resolves when the initial turn is added.
+ * @param characterId - The ID of the character to start a chat with.
+ * @returns AddTurnResponse containing chat metadata and the greeting turn.
+ */
+const createNewConversation = async (characterId) => {
+    if (!characterId)
+        throw Error('Character ID is required for creating new conversation');
+    const websocket = (0, Websocket_1.getSocket)();
+    return new Promise((resolve, reject) => {
+        const request_id = (0, uuid_1.v4)();
+        const profile = (0, Auth_1.getProfile)();
+        const request = {
+            command: "create_chat",
+            request_id,
+            payload: {
+                chat: {
+                    character_id: characterId,
+                    creator_id: profile.user.id.toString(),
+                    chat_id: request_id,
+                    type: 'TYPE_ONE_ON_ONE',
+                    visibility: 'VISIBILITY_PRIVATE'
+                },
+                chat_type: 'TYPE_ONE_ON_ONE',
+                with_greeting: true,
+            },
+            origin_id: "web-next"
+        };
+        const messageHandler = (data) => {
+            try {
+                const message = data.toString('utf-8');
+                const response = JSON.parse(message);
+                if (response.command === 'add_turn' && response.request_id === request_id) {
+                    clearTimeout(timeout);
+                    EventBus_1.default.off('message', messageHandler);
+                    resolve(response);
+                }
+            }
+            catch { }
+        };
+        EventBus_1.default.on('message', messageHandler);
+        const timeout = setTimeout(() => {
+            EventBus_1.default.off('message', messageHandler);
+            reject(new Error('Timeout waiting for response'));
+        }, 30000);
+        websocket.send(JSON.stringify(request));
+    });
+};
+exports.createNewConversation = createNewConversation;
+/**
+ * Sends a message to an existing chat and waits for the final reply.
+ * Uses the WebSocket to create and generate a turn, resolving on final candidate.
+ * @param message - The user's text message to send.
+ * @param characterId - The target character's ID.
+ * @param chatId - The ID of the chat where the message is posted.
+ * @returns UpdateTurnResponse containing the generated turn with final candidate.
+ */
+const sendMessage = async (message, characterId, chatId) => {
+    if (!message)
+        throw Error('Message is required for sending message');
+    if (!chatId)
+        throw Error('Chat ID is required for sending message');
+    if (!characterId)
+        throw Error('Character ID is required for sending message');
+    const websocket = (0, Websocket_1.getSocket)();
+    return new Promise((resolve, reject) => {
+        console.log('sending message');
+        const uuid = (0, uuid_1.v4)();
+        const profile = (0, Auth_1.getProfile)();
+        const request = {
+            command: "create_and_generate_turn",
+            request_id: uuid,
+            payload: {
+                chat_type: "TYPE_ONE_ON_ONE",
+                num_candidates: 1,
+                tts_enabled: false,
+                selected_language: "",
+                character_id: characterId,
+                user_name: profile.user.username,
+                turn: {
+                    turn_key: {
+                        turn_id: uuid,
+                        chat_id: chatId
+                    },
+                    author: {
+                        author_id: profile.user.id.toString(),
+                        is_human: true,
+                        name: profile.user.username
+                    },
+                    candidates: [
+                        {
+                            candidate_id: uuid,
+                            raw_content: message
+                        }
+                    ],
+                    primary_candidate_id: uuid
+                },
+                previous_annotations: {
+                    boring: 0,
+                    not_boring: 0,
+                    inaccurate: 0,
+                    not_inaccurate: 0,
+                    repetitive: 0,
+                    not_repetitive: 0,
+                    out_of_character: 0,
+                    not_out_of_character: 0,
+                    bad_memory: 0,
+                    not_bad_memory: 0,
+                    long: 0,
+                    not_long: 0,
+                    short: 0,
+                    not_short: 0,
+                    ends_chat_early: 0,
+                    not_ends_chat_early: 0,
+                    funny: 0,
+                    not_funny: 0,
+                    interesting: 0,
+                    not_interesting: 0,
+                    helpful: 0,
+                    not_helpful: 0
+                },
+                generate_comparison: false
+            },
+            origin_id: "web-next"
+        };
+        const messageHandler = (data) => {
+            try {
+                const message = data.toString('utf-8');
+                const response = JSON.parse(message);
+                if (response.command === 'update_turn' && response.request_id === uuid && response.turn.candidates[0]?.is_final) {
+                    clearTimeout(timeout);
+                    EventBus_1.default.off('message', messageHandler);
+                    resolve(response);
+                }
+            }
+            catch { }
+        };
+        EventBus_1.default.on('message', messageHandler);
+        const timeout = setTimeout(() => {
+            EventBus_1.default.off('message', messageHandler);
+            reject(new Error('Timeout waiting for response'));
+        }, 30000);
+        websocket.send(JSON.stringify(request));
+    });
+};
+exports.sendMessage = sendMessage;
+/**
+ * Retrieves up to 50 messages (turns) for a given chat.
+ * If a `token` is provided, it fetches the next page of results.
+ * @param chatId - The ID of the chat whose messages are to be fetched.
+ * @param token - Optional pagination token for retrieving the next batch.
+ * @return Parsed JSON containing up to 50 messages.
+ */
+const getMessages = async (chatId, token) => {
+    const query = token ? `?next_token=${encodeURIComponent(token)}` : '';
+    const req = await (0, api_1.request)(`https://neo.character.ai/turns/${chatId}/${query}`, {
+        method: 'GET',
+        includeAuthorization: true
+    });
+    const result = await req.json();
+    return result.turns;
+};
+exports.getMessages = getMessages;
+//# sourceMappingURL=index.js.map

package/dist/Chat/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/Chat/index.ts"],"names":[],"mappings":";;;;;;AAAA,2DAAkC;AAClC,kCAAqC;AAErC,4CAAyC;AACzC,+BAA0B;AAC1B,gCAAiC;AAEjC;;;;;GAKG;AACI,MAAM,qBAAqB,GAAG,KAAK,EAAE,WAAmB,EAA4B,EAAE;IACzF,IAAI,CAAC,WAAW;QAAE,MAAM,KAAK,CAAC,wDAAwD,CAAC,CAAC;IACxF,MAAM,SAAS,GAAG,IAAA,qBAAS,GAAE,CAAC;IAC9B,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;QACnC,MAAM,UAAU,GAAG,IAAA,SAAE,GAAE,CAAC;QACxB,MAAM,OAAO,GAAG,IAAA,iBAAU,GAAE,CAAC;QAC7B,MAAM,OAAO,GAAsB;YAC/B,OAAO,EAAE,aAAa;YACtB,UAAU;YACV,OAAO,EAAE;gBACL,IAAI,EAAE;oBACF,YAAY,EAAE,WAAW;oBACzB,UAAU,EAAE,OAAO,CAAC,IAAI,CAAC,EAAE,CAAC,QAAQ,EAAE;oBACtC,OAAO,EAAE,UAAU;oBACnB,IAAI,EAAE,iBAAiB;oBACvB,UAAU,EAAE,oBAAoB;iBACnC;gBACD,SAAS,EAAE,iBAAiB;gBAC5B,aAAa,EAAE,IAAI;aACtB;YACD,SAAS,EAAE,UAAU;SACxB,CAAC;QAEF,MAAM,cAAc,GAAG,CAAC,IAAY,EAAE,EAAE;YACpC,IAAI,CAAC;gBACD,MAAM,OAAO,GAAG,IAAI,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC;gBACvC,MAAM,QAAQ,GAAG,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;gBACrC,IAAI,QAAQ,CAAC,OAAO,KAAK,UAAU,IAAI,QAAQ,CAAC,UAAU,KAAK,UAAU,EAAE,CAAC;oBACxE,YAAY,CAAC,OAAO,CAAC,CAAC;oBACtB,kBAAO,CAAC,GAAG,CAAC,SAAS,EAAE,cAAc,CAAC,CAAC;oBACvC,OAAO,CAAC,QAA2B,CAAC,CAAC;gBACzC,CAAC;YACL,CAAC;YAAC,MAAM,CAAC,CAAA,CAAC;QACd,CAAC,CAAC;QAEF,kBAAO,CAAC,EAAE,CAAC,SAAS,EAAE,cAAc,CAAC,CAAC;QACtC,MAAM,OAAO,GAAG,UAAU,CAAC,GAAG,EAAE;YAC5B,kBAAO,CAAC,GAAG,CAAC,SAAS,EAAE,cAAc,CAAC,CAAC;YACvC,MAAM,CAAC,IAAI,KAAK,CAAC,8BAA8B,CAAC,CAAC,CAAC;QACtD,CAAC,EAAE,KAAK,CAAC,CAAC;QACV,SAAS,CAAC,IAAI,CAAC,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC,CAAC;IAC5C,CAAC,CAAC,CAAC;AACP,CAAC,CAAC;AA1CW,QAAA,qBAAqB,yBA0ChC;AAEF;;;;;;;GAOG;AACI,MAAM,WAAW,GAAG,KAAK,EAAE,OAAe,EAAE,WAAmB,EAAE,MAAc,EAA+B,EAAE;IACnH,IAAI,CAAC,OAAO;QAAE,MAAM,KAAK,CAAC,yCAAyC,CAAC,CAAC;IACrE,IAAI,CAAC,MAAM;QAAE,MAAM,KAAK,CAAC,yCAAyC,CAAC,CAAC;IACpE,IAAI,CAAC,WAAW;QAAE,MAAM,KAAK,CAAC,8CAA8C,CAAC,CAAC;IAC9E,MAAM,SAAS,GAAG,IAAA,qBAAS,GAAE,CAAC;IAC9B,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;QACnC,OAAO,CAAC,GAAG,CAAC,iBAAiB,CAAC,CAAA;QAC9B,MAAM,IAAI,GAAG,IAAA,SAAE,GAAE,CAAC;QAClB,MAAM,OAAO,GAAG,IAAA,iBAAU,GAAE,CAAC;QAC7B,MAAM,OAAO,GAAiC;YAC1C,OAAO,EAAE,0BAA0B;YACnC,UAAU,EAAE,IAAI;YAChB,OAAO,EAAE;gBACL,SAAS,EAAE,iBAAiB;gBAC5B,cAAc,EAAE,CAAC;gBACjB,WAAW,EAAE,KAAK;gBAClB,iBAAiB,EAAE,EAAE;gBACrB,YAAY,EAAE,WAAW;gBACzB,SAAS,EAAE,OAAO,CAAC,IAAI,CAAC,QAAQ;gBAChC,IAAI,EAAE;oBACF,QAAQ,EAAE;wBACN,OAAO,EAAE,IAAI;wBACb,OAAO,EAAE,MAAM;qBAClB;oBACD,MAAM,EAAE;wBACJ,SAAS,EAAE,OAAO,CAAC,IAAI,CAAC,EAAE,CAAC,QAAQ,EAAE;wBACrC,QAAQ,EAAE,IAAI;wBACd,IAAI,EAAE,OAAO,CAAC,IAAI,CAAC,QAAQ;qBAC9B;oBACD,UAAU,EAAE;wBACR;4BACI,YAAY,EAAE,IAAI;4BAClB,WAAW,EAAE,OAAO;yBACvB;qBACJ;oBACD,oBAAoB,EAAE,IAAI;iBAC7B;gBACD,oBAAoB,EAAE;oBAClB,MAAM,EAAE,CAAC;oBACT,UAAU,EAAE,CAAC;oBACb,UAAU,EAAE,CAAC;oBACb,cAAc,EAAE,CAAC;oBACjB,UAAU,EAAE,CAAC;oBACb,cAAc,EAAE,CAAC;oBACjB,gBAAgB,EAAE,CAAC;oBACnB,oBAAoB,EAAE,CAAC;oBACvB,UAAU,EAAE,CAAC;oBACb,cAAc,EAAE,CAAC;oBACjB,IAAI,EAAE,CAAC;oBACP,QAAQ,EAAE,CAAC;oBACX,KAAK,EAAE,CAAC;oBACR,SAAS,EAAE,CAAC;oBACZ,eAAe,EAAE,CAAC;oBAClB,mBAAmB,EAAE,CAAC;oBACtB,KAAK,EAAE,CAAC;oBACR,SAAS,EAAE,CAAC;oBACZ,WAAW,EAAE,CAAC;oBACd,eAAe,EAAE,CAAC;oBAClB,OAAO,EAAE,CAAC;oBACV,WAAW,EAAE,CAAC;iBACjB;gBACD,mBAAmB,EAAE,KAAK;aAC7B;YACD,SAAS,EAAE,UAAU;SACxB,CAAC;QAEF,MAAM,cAAc,GAAG,CAAC,IAAY,EAAE,EAAE;YACpC,IAAI,CAAC;gBACD,MAAM,OAAO,GAAG,IAAI,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC;gBACvC,MAAM,QAAQ,GAAG,IAAI,CAAC,KAAK,CAAC,OAAO,CAAuB,CAAC;gBAC3D,IAAI,QAAQ,CAAC,OAAO,KAAK,aAAa,IAAI,QAAQ,CAAC,UAAU,KAAK,IAAI,IAAI,QAAQ,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC,CAAC,EAAE,QAAQ,EAAE,CAAC;oBAC9G,YAAY,CAAC,OAAO,CAAC,CAAC;oBACtB,kBAAO,CAAC,GAAG,CAAC,SAAS,EAAE,cAAc,CAAC,CAAC;oBACvC,OAAO,CAAC,QAAQ,CAAC,CAAC;gBACtB,CAAC;YACL,CAAC;YAAC,MAAM,CAAC,CAAA,CAAC;QACd,CAAC,CAAC;QAEF,kBAAO,CAAC,EAAE,CAAC,SAAS,EAAE,cAAc,CAAC,CAAC;QACtC,MAAM,OAAO,GAAG,UAAU,CAAC,GAAG,EAAE;YAC5B,kBAAO,CAAC,GAAG,CAAC,SAAS,EAAE,cAAc,CAAC,CAAC;YACvC,MAAM,CAAC,IAAI,KAAK,CAAC,8BAA8B,CAAC,CAAC,CAAC;QACtD,CAAC,EAAE,KAAK,CAAC,CAAC;QACV,SAAS,CAAC,IAAI,CAAC,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC,CAAC;IAC5C,CAAC,CAAC,CAAC;AACP,CAAC,CAAC;AArFW,QAAA,WAAW,eAqFtB;AAEF;;;;;;GAMG;AACI,MAAM,WAAW,GAAG,KAAK,EAAE,MAAc,EAAE,KAAc,EAAoB,EAAE;IAClF,MAAM,KAAK,GAAG,KAAK,CAAC,CAAC,CAAC,eAAe,kBAAkB,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;IACtE,MAAM,GAAG,GAAG,MAAM,IAAA,aAAO,EAAC,kCAAkC,MAAM,IAAI,KAAK,EAAE,EAAE;QAC3E,MAAM,EAAE,KAAK;QACb,oBAAoB,EAAE,IAAI;KAC7B,CAAC,CAAC;IAEH,MAAM,MAAM,GAAG,MAAM,GAAG,CAAC,IAAI,EAAE,CAAC;IAEhC,OAAO,MAAM,CAAC,KAAK,CAAC;AACxB,CAAC,CAAA;AAVY,QAAA,WAAW,eAUvB"}

package/dist/EventBus/index.d.ts

@@ -0,0 +1,8 @@
+import { EventEmitter } from 'events';
+declare const emitter: EventEmitter<any>;
+/**
+ * Global event bus used to broadcast WebSocket messages and errors.
+ * Subscribers can listen to 'message' and other events across modules.
+ */
+export default emitter;
+//# sourceMappingURL=index.d.ts.map

package/dist/EventBus/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/EventBus/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,QAAQ,CAAC;AAEtC,QAAA,MAAM,OAAO,mBAAqB,CAAC;AAEnC;;;GAGG;AACH,eAAe,OAAO,CAAC"}

package/dist/EventBus/index.js

@@ -0,0 +1,10 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const events_1 = require("events");
+const emitter = new events_1.EventEmitter();
+/**
+ * Global event bus used to broadcast WebSocket messages and errors.
+ * Subscribers can listen to 'message' and other events across modules.
+ */
+exports.default = emitter;
+//# sourceMappingURL=index.js.map

package/dist/EventBus/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/EventBus/index.ts"],"names":[],"mappings":";;AAAA,mCAAsC;AAEtC,MAAM,OAAO,GAAG,IAAI,qBAAY,EAAE,CAAC;AAEnC;;;GAGG;AACH,kBAAe,OAAO,CAAC"}

package/dist/Websocket/index.d.ts

@@ -0,0 +1,20 @@
+import { WebSocket } from 'ws';
+interface Options {
+    edgeRollout: string | '60';
+    authorization: string;
+}
+/**
+ * Establishes (or reuses) a WebSocket connection to Character.AI.
+ * Emits incoming messages through the global EventBus for subscribers.
+ * Handles reconnection attempts on unexpected close events.
+ * @param options - Initial connection options containing auth and rollout.
+ * @returns Resolves when the socket is open and ready.
+ */
+export declare const connect: (options?: Options) => Promise<void>;
+/**
+ * Returns the current WebSocket instance.
+ * @returns Active WebSocket or undefined if not connected.
+ */
+export declare const getSocket: () => WebSocket;
+export {};
+//# sourceMappingURL=index.d.ts.map

package/dist/Websocket/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/Websocket/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,IAAI,CAAC;AAG/B,UAAU,OAAO;IACb,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,aAAa,EAAE,MAAM,CAAC;CACzB;AAMD;;;;;;GAMG;AACH,eAAO,MAAM,OAAO,GAAU,UAAU,OAAO,KAAI,OAAO,CAAC,IAAI,CAgD9D,CAAA;AAED;;;GAGG;AACH,eAAO,MAAM,SAAS,QAAQ,SAE7B,CAAA"}

package/dist/Websocket/index.js

@@ -0,0 +1,72 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getSocket = exports.connect = void 0;
+const ws_1 = require("ws");
+const EventBus_1 = __importDefault(require("../EventBus"));
+let websocket;
+let savedOptions;
+let reconnectAttempts = 0;
+/**
+ * Establishes (or reuses) a WebSocket connection to Character.AI.
+ * Emits incoming messages through the global EventBus for subscribers.
+ * Handles reconnection attempts on unexpected close events.
+ * @param options - Initial connection options containing auth and rollout.
+ * @returns Resolves when the socket is open and ready.
+ */
+const connect = async (options) => {
+    await new Promise((resolve, reject) => {
+        if (options)
+            savedOptions = options;
+        if (!savedOptions && !options)
+            return reject(new Error("Options required for initial connection"));
+        const opts = options || savedOptions;
+        if (websocket && websocket.readyState === ws_1.WebSocket.OPEN)
+            return resolve(websocket);
+        websocket = new ws_1.WebSocket('wss://neo.character.ai/ws/', {
+            headers: {
+                cookie: `HTTP_AUTHORIZATION="Token ${opts.authorization}"; edge_rollout=${opts.edgeRollout};`,
+                "Origin": "https://character.ai",
+                "Referer": "https://character.ai/",
+                "User-Agent": "Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/120.0.0.0 Safari/537.36"
+            }
+        });
+        websocket.on('message', data => {
+            EventBus_1.default.emit('message', data);
+        });
+        websocket.once('open', () => {
+            console.log('Character AI connected');
+            reconnectAttempts = 0;
+            resolve(websocket);
+        });
+        websocket.on('error', e => {
+            console.log('Character AI error:', e);
+            if (options)
+                reject(e);
+        });
+        websocket.on('close', (code, reason) => {
+            console.log(`Character AI disconnected (Code: ${code}, Reason: ${reason})`);
+            if (reconnectAttempts >= 5) {
+                console.log('Max reconnection attempts (5) reached. Giving up.');
+                return;
+            }
+            reconnectAttempts++;
+            console.log(`Attempting to reconnect in 5 seconds... (Attempt ${reconnectAttempts}/5)`);
+            setTimeout(() => {
+                (0, exports.connect)().catch(e => console.error("Reconnection failed:", e));
+            }, 5000);
+        });
+    });
+};
+exports.connect = connect;
+/**
+ * Returns the current WebSocket instance.
+ * @returns Active WebSocket or undefined if not connected.
+ */
+const getSocket = () => {
+    return websocket;
+};
+exports.getSocket = getSocket;
+//# sourceMappingURL=index.js.map

package/dist/Websocket/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/Websocket/index.ts"],"names":[],"mappings":";;;;;;AAAA,2BAA+B;AAC/B,2DAAkC;AAOlC,IAAI,SAAqB,CAAC;AAC1B,IAAI,YAAqB,CAAC;AAC1B,IAAI,iBAAiB,GAAG,CAAC,CAAC;AAE1B;;;;;;GAMG;AACI,MAAM,OAAO,GAAG,KAAK,EAAE,OAAiB,EAAkB,EAAE;IAC/D,MAAM,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;QAClC,IAAI,OAAO;YAAE,YAAY,GAAG,OAAO,CAAC;QACpC,IAAI,CAAC,YAAY,IAAI,CAAC,OAAO;YAAE,OAAO,MAAM,CAAC,IAAI,KAAK,CAAC,yCAAyC,CAAC,CAAC,CAAC;QAEnG,MAAM,IAAI,GAAG,OAAO,IAAI,YAAY,CAAC;QAErC,IAAI,SAAS,IAAI,SAAS,CAAC,UAAU,KAAK,cAAS,CAAC,IAAI;YAAE,OAAO,OAAO,CAAC,SAAS,CAAC,CAAC;QAEpF,SAAS,GAAG,IAAI,cAAS,CAAC,4BAA4B,EAAE;YACpD,OAAO,EAAE;gBACL,MAAM,EAAE,6BAA6B,IAAI,CAAC,aAAa,mBAAmB,IAAI,CAAC,WAAW,GAAG;gBAC7F,QAAQ,EAAE,sBAAsB;gBAChC,SAAS,EAAE,uBAAuB;gBAClC,YAAY,EAAE,iHAAiH;aAClI;SACJ,CAAC,CAAC;QAEH,SAAS,CAAC,EAAE,CAAC,SAAS,EAAE,IAAI,CAAC,EAAE;YAC3B,kBAAO,CAAC,IAAI,CAAC,SAAS,EAAE,IAAI,CAAC,CAAC;QAClC,CAAC,CAAC,CAAC;QAEH,SAAS,CAAC,IAAI,CAAC,MAAM,EAAE,GAAG,EAAE;YACxB,OAAO,CAAC,GAAG,CAAC,wBAAwB,CAAC,CAAC;YACtC,iBAAiB,GAAG,CAAC,CAAC;YACtB,OAAO,CAAC,SAAS,CAAC,CAAC;QACvB,CAAC,CAAC,CAAC;QAEH,SAAS,CAAC,EAAE,CAAC,OAAO,EAAE,CAAC,CAAC,EAAE;YACtB,OAAO,CAAC,GAAG,CAAC,qBAAqB,EAAE,CAAC,CAAC,CAAC;YACtC,IAAI,OAAO;gBAAE,MAAM,CAAC,CAAC,CAAC,CAAC;QAC3B,CAAC,CAAC,CAAC;QAEH,SAAS,CAAC,EAAE,CAAC,OAAO,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE;YACnC,OAAO,CAAC,GAAG,CAAC,oCAAoC,IAAI,aAAa,MAAM,GAAG,CAAC,CAAC;YAE5E,IAAI,iBAAiB,IAAI,CAAC,EAAE,CAAC;gBACzB,OAAO,CAAC,GAAG,CAAC,mDAAmD,CAAC,CAAC;gBACjE,OAAO;YACX,CAAC;YAED,iBAAiB,EAAE,CAAC;YACpB,OAAO,CAAC,GAAG,CAAC,oDAAoD,iBAAiB,KAAK,CAAC,CAAC;YACxF,UAAU,CAAC,GAAG,EAAE;gBACZ,IAAA,eAAO,GAAE,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,CAAC,OAAO,CAAC,KAAK,CAAC,sBAAsB,EAAE,CAAC,CAAC,CAAC,CAAC;YACnE,CAAC,EAAE,IAAI,CAAC,CAAC;QACb,CAAC,CAAC,CAAC;IACP,CAAC,CAAC,CAAC;AACP,CAAC,CAAA;AAhDY,QAAA,OAAO,WAgDnB;AAED;;;GAGG;AACI,MAAM,SAAS,GAAG,GAAe,EAAE;IACtC,OAAO,SAAS,CAAC;AACrB,CAAC,CAAA;AAFY,QAAA,SAAS,aAErB"}

package/dist/api.d.ts

@@ -0,0 +1,23 @@
+interface RequesterOptions {
+    method: 'GET' | 'POST' | 'PATCH' | 'PUT' | 'DELETE';
+    includeAuthorization?: boolean;
+    body?: string;
+    contentType?: 'application/json' | 'application/x-www-form-urlencoded' | 'multipart/form-data';
+    formData?: Record<string, string | Blob>;
+    fileFieldName?: string;
+}
+/**
+ * Updates the module-level authorization header value.
+ * @param token - Raw session token string without the "Token " prefix.
+ */
+export declare const updateToken: (token: string) => void;
+/**
+ * Performs an HTTP request to Character.AI with optional authorization.
+ * Adds realistic browser headers and supports JSON or form payloads.
+ * @param url - Target endpoint URL.
+ * @param options - Request options including method, auth, and body.
+ * @returns Fetch Response from the remote server.
+ */
+export declare const request: (url: string, options: RequesterOptions) => Promise<Response>;
+export {};
+//# sourceMappingURL=api.d.ts.map

package/dist/api.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"api.d.ts","sourceRoot":"","sources":["../src/api.ts"],"names":[],"mappings":"AAEA,UAAU,gBAAgB;IACtB,MAAM,EAAE,KAAK,GAAG,MAAM,GAAG,OAAO,GAAG,KAAK,GAAG,QAAQ,CAAC;IACpD,oBAAoB,CAAC,EAAE,OAAO,CAAC;IAC/B,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,WAAW,CAAC,EAAE,kBAAkB,GAAG,mCAAmC,GAAG,qBAAqB,CAAC;IAC/F,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC,CAAC;IACzC,aAAa,CAAC,EAAE,MAAM,CAAC;CAC1B;AAID;;;GAGG;AACH,eAAO,MAAM,WAAW,GAAI,OAAO,MAAM,SAGxC,CAAA;AAED;;;;;;GAMG;AACH,eAAO,MAAM,OAAO,GAAU,KAAK,MAAM,EAAE,SAAS,gBAAgB,sBA6BnE,CAAA"}

package/dist/api.js

@@ -0,0 +1,51 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.request = exports.updateToken = void 0;
+let authorization = "";
+/**
+ * Updates the module-level authorization header value.
+ * @param token - Raw session token string without the "Token " prefix.
+ */
+const updateToken = (token) => {
+    if (!token)
+        return;
+    authorization = `Token ${token}`;
+};
+exports.updateToken = updateToken;
+/**
+ * Performs an HTTP request to Character.AI with optional authorization.
+ * Adds realistic browser headers and supports JSON or form payloads.
+ * @param url - Target endpoint URL.
+ * @param options - Request options including method, auth, and body.
+ * @returns Fetch Response from the remote server.
+ */
+const request = async (url, options) => {
+    let headers = {
+        "User-Agent": "Character.AI",
+        "DNT": "1",
+        "Sec-GPC": "1",
+        "Connection": "close",
+        "Upgrade-Insecure-Requests": "1",
+        "Sec-Fetch-Dest": "empty",
+        "Sec-Fetch-Mode": "cors",
+        "Sec-Fetch-Site": "same-origin",
+        "Origin": "https://character.ai",
+        "Referer": "https://character.ai/",
+        "TE": "trailers"
+    };
+    let body = options.body;
+    if (options.includeAuthorization)
+        headers["Authorization"] = authorization;
+    if (options.contentType)
+        headers["Content-Type"] = options.contentType;
+    if (options.formData) {
+        const formData = options.contentType == 'application/x-www-form-urlencoded' ? new URLSearchParams() : new FormData();
+        Object.entries(options.formData).forEach((entry) => formData.append(entry[0], entry[1]));
+        body = formData;
+    }
+    if (typeof body === "string")
+        headers["Content-Length"] = body.length;
+    return await fetch(url, { headers, method: options.method, body });
+};
+exports.request = request;
+//# sourceMappingURL=api.js.map

package/dist/api.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"api.js","sourceRoot":"","sources":["../src/api.ts"],"names":[],"mappings":";;;AAWA,IAAI,aAAa,GAAW,EAAE,CAAC;AAE/B;;;GAGG;AACI,MAAM,WAAW,GAAG,CAAC,KAAa,EAAE,EAAE;IACzC,IAAI,CAAC,KAAK;QAAE,OAAO;IACnB,aAAa,GAAG,SAAS,KAAK,EAAE,CAAC;AACrC,CAAC,CAAA;AAHY,QAAA,WAAW,eAGvB;AAED;;;;;;GAMG;AACI,MAAM,OAAO,GAAG,KAAK,EAAE,GAAW,EAAE,OAAyB,EAAE,EAAE;IACpE,IAAI,OAAO,GAAQ;QACf,YAAY,EAAE,cAAc;QAC5B,KAAK,EAAE,GAAG;QACV,SAAS,EAAE,GAAG;QACd,YAAY,EAAE,OAAO;QACrB,2BAA2B,EAAE,GAAG;QAChC,gBAAgB,EAAE,OAAO;QACzB,gBAAgB,EAAE,MAAM;QACxB,gBAAgB,EAAE,aAAa;QAC/B,QAAQ,EAAE,sBAAsB;QAChC,SAAS,EAAE,uBAAuB;QAClC,IAAI,EAAE,UAAU;KACnB,CAAA;IAED,IAAI,IAAI,GAAQ,OAAO,CAAC,IAAI,CAAC;IAE7B,IAAI,OAAO,CAAC,oBAAoB;QAAE,OAAO,CAAC,eAAe,CAAC,GAAG,aAAa,CAAC;IAC3E,IAAI,OAAO,CAAC,WAAW;QAAE,OAAO,CAAC,cAAc,CAAC,GAAG,OAAO,CAAC,WAAW,CAAC;IAEvE,IAAI,OAAO,CAAC,QAAQ,EAAE,CAAC;QACnB,MAAM,QAAQ,GAAG,OAAO,CAAC,WAAW,IAAI,mCAAmC,CAAC,CAAC,CAAC,IAAI,eAAe,EAAE,CAAC,CAAC,CAAC,IAAI,QAAQ,EAAE,CAAC;QACrH,MAAM,CAAC,OAAO,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC,OAAO,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,QAAQ,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC,CAAQ,CAAC,CAAC,CAAC;QAChG,IAAI,GAAG,QAAQ,CAAC;IACpB,CAAC;IAED,IAAI,OAAO,IAAI,KAAK,QAAQ;QAAE,OAAO,CAAC,gBAAgB,CAAC,GAAG,IAAI,CAAC,MAAM,CAAC;IAEtE,OAAO,MAAM,KAAK,CAAC,GAAG,EAAE,EAAE,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC;AACvE,CAAC,CAAA;AA7BY,QAAA,OAAO,WA6BnB"}

package/dist/index.d.ts

@@ -0,0 +1,3 @@
+export * from './Auth';
+export * from './Chat';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,QAAQ,CAAC;AACvB,cAAc,QAAQ,CAAC"}

package/dist/index.js

@@ -0,0 +1,19 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./Auth"), exports);
+__exportStar(require("./Chat"), exports);
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,yCAAuB;AACvB,yCAAuB"}

package/dist/types/Chat.d.ts

@@ -0,0 +1,127 @@
+export interface TurnKey {
+    turn_id: string;
+    chat_id: string;
+}
+export interface Author {
+    author_id: string;
+    is_human?: boolean;
+    name: string;
+}
+export interface Editor {
+    author_id: string;
+    name: string;
+}
+export interface Candidate {
+    candidate_id: string;
+    raw_content: string;
+    create_time?: string;
+    is_final?: boolean;
+    model_type?: string;
+    editor?: Editor;
+}
+export interface PreviousAnnotations {
+    boring: number;
+    not_boring: number;
+    inaccurate: number;
+    not_inaccurate: number;
+    repetitive: number;
+    not_repetitive: number;
+    out_of_character: number;
+    not_out_of_character: number;
+    bad_memory: number;
+    not_bad_memory: number;
+    long: number;
+    not_long: number;
+    short: number;
+    not_short: number;
+    ends_chat_early: number;
+    not_ends_chat_early: number;
+    funny: number;
+    not_funny: number;
+    interesting: number;
+    not_interesting: number;
+    helpful: number;
+    not_helpful: number;
+}
+export interface Turn {
+    turn_key: TurnKey;
+    author: Author;
+    candidates: Candidate[];
+    primary_candidate_id: string;
+    create_time?: string;
+    last_update_time?: string;
+    state?: string;
+}
+export interface Payload {
+    chat_type: 'TYPE_ONE_ON_ONE';
+    num_candidates: number;
+    tts_enabled: boolean;
+    selected_language: string;
+    character_id: string;
+    user_name: string;
+    turn: Turn;
+    previous_annotations: PreviousAnnotations;
+    generate_comparison: boolean;
+}
+export interface CreateAndGenerateTurnRequest {
+    command: 'create_and_generate_turn';
+    request_id: string;
+    payload: Payload;
+    origin_id: 'web-next';
+}
+export interface ChatInfo {
+    type: 'TYPE_ONE_ON_ONE';
+}
+export interface GenerationMode {
+    mode: 'MODE_NORMAL';
+    remaining_quota_frac: number;
+}
+export interface AddTurnResponse {
+    turn: Turn;
+    chat_info: ChatInfo;
+    command: 'add_turn';
+    request_id: string;
+    generation_mode?: GenerationMode;
+}
+export interface UpdateTurnResponse {
+    turn: Turn;
+    chat_info: ChatInfo;
+    generation_mode: GenerationMode;
+    command: 'update_turn';
+    request_id: string;
+}
+export interface ChatProperties {
+    chat_id: string;
+    creator_id: string | number;
+    visibility: 'VISIBILITY_PRIVATE';
+    character_id: string;
+    type: 'TYPE_ONE_ON_ONE';
+}
+export interface CreateChatPayload {
+    chat_type: 'TYPE_ONE_ON_ONE';
+    chat: ChatProperties;
+    with_greeting: boolean;
+}
+export interface CreateChatRequest {
+    command: 'create_chat';
+    request_id: string;
+    payload: CreateChatPayload;
+    origin_id: 'web-next';
+}
+export interface ChatResponseProperties {
+    chat_id: string;
+    create_time: string;
+    creator_id: string;
+    character_id: string;
+    state: 'STATE_ACTIVE';
+    type: 'TYPE_ONE_ON_ONE';
+    visibility: 'VISIBILITY_PRIVATE';
+    preferred_model_type: 'MODEL_TYPE_DEEP_SYNTH_LITE';
+    model_preference_version: string;
+}
+export interface CreateChatResponse {
+    chat: ChatResponseProperties;
+    command: 'create_chat_response';
+    request_id: string;
+}
+//# sourceMappingURL=Chat.d.ts.map

package/dist/types/Chat.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Chat.d.ts","sourceRoot":"","sources":["../../src/types/Chat.ts"],"names":[],"mappings":"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"}

package/dist/types/Chat.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=Chat.js.map

package/dist/types/Chat.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Chat.js","sourceRoot":"","sources":["../../src/types/Chat.ts"],"names":[],"mappings":""}

package/dist/types/Profile.d.ts

@@ -0,0 +1,29 @@
+export interface Profile {
+    user: {
+        username: string;
+        id: number;
+        first_name: string;
+        account: {
+            name: string;
+            avatar_type: string | 'DEFAULT';
+            onboarding_complete: boolean;
+            avatar_file_name: string;
+            mobile_onboarding_complete: boolean | null;
+        };
+        is_staff: boolean;
+        subscription: any | null;
+        entitlements: any[];
+    };
+    is_human: boolean;
+    name: string;
+    email: string;
+    date_joined: string;
+    needs_to_acknowledge_policy: boolean;
+    suspended_until: string | null;
+    hidden_characters: any[];
+    blocked_users: any[];
+    bio: string;
+    interests: any | null;
+    date_of_birth: string;
+}
+//# sourceMappingURL=Profile.d.ts.map

package/dist/types/Profile.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Profile.d.ts","sourceRoot":"","sources":["../../src/types/Profile.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,OAAO;IACtB,IAAI,EAAE;QACJ,QAAQ,EAAE,MAAM,CAAC;QACjB,EAAE,EAAE,MAAM,CAAC;QACX,UAAU,EAAE,MAAM,CAAC;QACnB,OAAO,EAAE;YACP,IAAI,EAAE,MAAM,CAAC;YACb,WAAW,EAAE,MAAM,GAAG,SAAS,CAAC;YAChC,mBAAmB,EAAE,OAAO,CAAC;YAC7B,gBAAgB,EAAE,MAAM,CAAC;YACzB,0BAA0B,EAAE,OAAO,GAAG,IAAI,CAAC;SAC5C,CAAC;QACF,QAAQ,EAAE,OAAO,CAAC;QAClB,YAAY,EAAE,GAAG,GAAG,IAAI,CAAC;QACzB,YAAY,EAAE,GAAG,EAAE,CAAC;KACrB,CAAC;IACF,QAAQ,EAAE,OAAO,CAAC;IAClB,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,EAAE,MAAM,CAAC;IACpB,2BAA2B,EAAE,OAAO,CAAC;IACrC,eAAe,EAAE,MAAM,GAAG,IAAI,CAAC;IAC/B,iBAAiB,EAAE,GAAG,EAAE,CAAC;IACzB,aAAa,EAAE,GAAG,EAAE,CAAC;IACrB,GAAG,EAAE,MAAM,CAAC;IACZ,SAAS,EAAE,GAAG,GAAG,IAAI,CAAC;IACtB,aAAa,EAAE,MAAM,CAAC;CACvB"}

package/dist/types/Profile.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=Profile.js.map

package/dist/types/Profile.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Profile.js","sourceRoot":"","sources":["../../src/types/Profile.ts"],"names":[],"mappings":""}

package/dist/types/index.d.ts

@@ -0,0 +1,3 @@
+export * from './Chat';
+export * from './Profile';
+//# sourceMappingURL=index.d.ts.map

package/dist/types/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/types/index.ts"],"names":[],"mappings":"AAAA,cAAc,QAAQ,CAAC;AACvB,cAAc,WAAW,CAAC"}

package/dist/types/index.js

@@ -0,0 +1,19 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./Chat"), exports);
+__exportStar(require("./Profile"), exports);
+//# sourceMappingURL=index.js.map

package/dist/types/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/types/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,yCAAuB;AACvB,4CAA0B"}

package/package.json

@@ -0,0 +1,42 @@
+{
+  "name": "simple_node_characterai",
+  "version": "1.1.0",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "scripts": {
+    "build": "tsc",
+    "prepublishOnly": "npm run build"
+  },
+  "files": [
+    "dist"
+  ],
+  "keywords": ["character", "ai", "character_ai", "cai", "c.ai", "characterai"],
+  "author": "Nadila Vira",
+  "license": "ISC",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/IqroNegoro/simple_node_characterai.git"
+  },
+  "homepage": "https://github.com/IqroNegoro/simple_node_characterai#readme",
+  "bugs": {
+    "url": "https://github.com/IqroNegoro/simple_node_characterai/issues"
+  },
+  "funding": {
+    "type": "individual",
+    "url": "https://github.com/sponsors/IqroNegoro"
+  },
+  "engines": {
+    "node": ">=22.12.0"
+  },
+  "description": "Simple Node.js library for interacting with Character.AI via HTTP and WebSocket with typescript",
+  "devDependencies": {
+    "@types/node": "^25.0.3",
+    "@types/uuid": "^11.0.0",
+    "@types/ws": "^8.18.1",
+    "typescript": "^5.9.3"
+  },
+  "dependencies": {
+    "uuid": "^13.0.0",
+    "ws": "^8.18.3"
+  }
+}