@kokimoki/app 3.1.3 → 3.1.5

package/dist/kokimoki-ai.d.ts

@@ -1,153 +0,0 @@
-import type { Upload } from "./types/upload";
-import { KokimokiClient } from "./kokimoki-client";
-/**
- * Kokimoki AI Integration Service
- *
- * Provides built-in AI capabilities for game applications without requiring API keys or setup.
- * Includes text generation, structured JSON output, and image modification.
- *
- * **Key Features:**
- * - Multiple AI models (GPT-4, GPT-5, Gemini variants)
- * - Text generation with configurable creativity (temperature)
- * - Structured JSON output for game data
- * - AI-powered image modifications
- * - No API keys or configuration required
- *
- * **Common Use Cases:**
- * - Generate dynamic game content (quests, dialogues, stories)
- * - Create AI opponents or NPCs with personalities
- * - Generate quiz questions or trivia
- * - Create game assets (character stats, item descriptions)
- * - Transform user-uploaded images
- * - Generate procedural content
- *
- * Access via `kmClient.ai`
- *
- * @example
- * ```typescript
- * // Generate story text
- * const story = await kmClient.ai.chat({
- *   systemPrompt: 'You are a fantasy story writer',
- *   userPrompt: 'Write a short quest description',
- *   temperature: 0.8
- * });
- *
- * // Generate structured game data
- * interface Enemy {
- *   name: string;
- *   health: number;
- *   attack: number;
- * }
- * const enemy = await kmClient.ai.generateJson<Enemy>({
- *   userPrompt: 'Create a level 5 goblin warrior'
- * });
- *
- * // Transform image
- * const modified = await kmClient.ai.modifyImage(
- *   imageUrl,
- *   'Make it look like pixel art'
- * );
- * ```
- */
-export declare class KokimokiAi {
-    private readonly client;
-    constructor(client: KokimokiClient);
-    /**
-     * Generate a chat response from the AI model.
-     *
-     * Sends a chat request to the AI service and returns the generated response.
-     * Supports multiple AI models including GPT and Gemini variants with configurable
-     * parameters for fine-tuning the response behavior.
-     *
-     * @param req The chat request parameters.
-     * @param req.model Optional. The AI model to use. Defaults to server-side default if not specified.
-     *                  Available models:
-     *                  - `gpt-4o`: OpenAI GPT-4 Optimized
-     *                  - `gpt-4o-mini`: Smaller, faster GPT-4 variant
-     *                  - `gpt-5`: OpenAI GPT-5 (latest)
-     *                  - `gpt-5-mini`: Smaller GPT-5 variant
-     *                  - `gpt-5-nano`: Smallest GPT-5 variant for lightweight tasks
-     *                  - `gemini-2.5-flash-lite`: Google Gemini lite variant
-     *                  - `gemini-2.5-flash`: Google Gemini fast variant
-     * @param req.systemPrompt Optional. The system message that sets the behavior and context for the AI.
-     *                         This helps define the AI's role, personality, and constraints.
-     * @param req.userPrompt The user's message or question to send to the AI.
-     * @param req.temperature Optional. Controls randomness in the response (0.0 to 1.0).
-     *                        Lower values make output more focused and deterministic,
-     *                        higher values make it more creative and varied.
-     * @param req.maxTokens Optional. The maximum number of tokens to generate in the response.
-     *                      Controls the length of the AI's output.
-     *
-     * @returns A promise that resolves to an object containing the AI-generated response.
-     * @returns {string} content The text content of the AI's response.
-     *
-     * @throws An error object if the API request fails.
-     *
-     * @example
-     * ```typescript
-     * const response = await client.ai.chat({
-     *   model: "gpt-4o",
-     *   systemPrompt: "You are a helpful coding assistant.",
-     *   userPrompt: "Explain what TypeScript is in one sentence.",
-     *   temperature: 0.7,
-     *   maxTokens: 100
-     * });
-     * console.log(response.content);
-     * ```
-     */
-    chat(req: {
-        model?: "gpt-4o" | "gpt-4o-mini" | "gpt-5" | "gpt-5-mini" | "gpt-5-nano" | "gemini-2.5-flash-lite" | "gemini-2.5-flash";
-        systemPrompt?: string;
-        userPrompt: string;
-        temperature?: number;
-        maxTokens?: number;
-        responseMimeType?: string;
-    }): Promise<{
-        content: string;
-    }>;
-    /**
-     * Generate structured JSON output from the AI model.
-     *
-     * Sends a chat request to the AI service with the expectation of receiving
-     * a JSON-formatted response. This is useful for scenarios where the output
-     * needs to be parsed or processed programmatically.
-     *
-     * @param req The chat request parameters.
-     * @param req.model Optional. The AI model to use. Defaults to server-side default if not specified.
-     *                  Available models:
-     *                  - `gpt-4o`: OpenAI GPT-4 Optimized
-     *                  - `gpt-4o-mini`: Smaller, faster GPT-4 variant
-     *                  - `gpt-5`: OpenAI GPT-5 (latest)
-     *                  - `gpt-5-mini`: Smaller GPT-5 variant
-     *                  - `gpt-5-nano`: Smallest GPT-5 variant for lightweight tasks
-     *                  - `gemini-2.5-flash-lite`: Google Gemini lite variant
-     *                  - `gemini-2.5-flash`: Google Gemini fast variant
-     * @param req.systemPrompt Optional. The system message that sets the behavior and context for the AI.
-     *                         This helps define the AI's role, personality, and constraints.
-     * @param req.userPrompt The user's message or question to send to the AI.
-     * @param req.temperature Optional. Controls randomness in the response (0.0 to 1.0).
-     *                        Lower values make output more focused and deterministic,
-     *                        higher values make it more creative and varied.
-     * @param req.maxTokens Optional. The maximum number of tokens to generate in the response.
-     *                      Controls the length of the AI's output.
-     *
-     * @returns A promise that resolves to the parsed JSON object generated by the AI.
-     *
-     * @throws An error object if the API request fails or if the response is not valid JSON.
-     */
-    generateJson<T extends object>(req: {
-        model?: "gpt-4o" | "gpt-4o-mini" | "gpt-5" | "gpt-5-mini" | "gpt-5-nano" | "gemini-2.5-flash-lite" | "gemini-2.5-flash";
-        systemPrompt?: string;
-        userPrompt: string;
-        temperature?: number;
-        maxTokens?: number;
-    }): Promise<T>;
-    /**
-     * Modify an image using the AI service.
-     * @param baseImageUrl The URL of the base image to modify.
-     * @param prompt The modification prompt to apply to the image.
-     * @param tags Optional. Tags to associate with the image.
-     * @returns A promise that resolves to the modified image upload information.
-     */
-    modifyImage(baseImageUrl: string, prompt: string, tags?: string[]): Promise<Upload>;
-}

package/dist/kokimoki-ai.js

@@ -1,164 +0,0 @@
-/**
- * Kokimoki AI Integration Service
- *
- * Provides built-in AI capabilities for game applications without requiring API keys or setup.
- * Includes text generation, structured JSON output, and image modification.
- *
- * **Key Features:**
- * - Multiple AI models (GPT-4, GPT-5, Gemini variants)
- * - Text generation with configurable creativity (temperature)
- * - Structured JSON output for game data
- * - AI-powered image modifications
- * - No API keys or configuration required
- *
- * **Common Use Cases:**
- * - Generate dynamic game content (quests, dialogues, stories)
- * - Create AI opponents or NPCs with personalities
- * - Generate quiz questions or trivia
- * - Create game assets (character stats, item descriptions)
- * - Transform user-uploaded images
- * - Generate procedural content
- *
- * Access via `kmClient.ai`
- *
- * @example
- * ```typescript
- * // Generate story text
- * const story = await kmClient.ai.chat({
- *   systemPrompt: 'You are a fantasy story writer',
- *   userPrompt: 'Write a short quest description',
- *   temperature: 0.8
- * });
- *
- * // Generate structured game data
- * interface Enemy {
- *   name: string;
- *   health: number;
- *   attack: number;
- * }
- * const enemy = await kmClient.ai.generateJson<Enemy>({
- *   userPrompt: 'Create a level 5 goblin warrior'
- * });
- *
- * // Transform image
- * const modified = await kmClient.ai.modifyImage(
- *   imageUrl,
- *   'Make it look like pixel art'
- * );
- * ```
- */
-export class KokimokiAi {
-    client;
-    constructor(client) {
-        this.client = client;
-    }
-    /**
-     * Generate a chat response from the AI model.
-     *
-     * Sends a chat request to the AI service and returns the generated response.
-     * Supports multiple AI models including GPT and Gemini variants with configurable
-     * parameters for fine-tuning the response behavior.
-     *
-     * @param req The chat request parameters.
-     * @param req.model Optional. The AI model to use. Defaults to server-side default if not specified.
-     *                  Available models:
-     *                  - `gpt-4o`: OpenAI GPT-4 Optimized
-     *                  - `gpt-4o-mini`: Smaller, faster GPT-4 variant
-     *                  - `gpt-5`: OpenAI GPT-5 (latest)
-     *                  - `gpt-5-mini`: Smaller GPT-5 variant
-     *                  - `gpt-5-nano`: Smallest GPT-5 variant for lightweight tasks
-     *                  - `gemini-2.5-flash-lite`: Google Gemini lite variant
-     *                  - `gemini-2.5-flash`: Google Gemini fast variant
-     * @param req.systemPrompt Optional. The system message that sets the behavior and context for the AI.
-     *                         This helps define the AI's role, personality, and constraints.
-     * @param req.userPrompt The user's message or question to send to the AI.
-     * @param req.temperature Optional. Controls randomness in the response (0.0 to 1.0).
-     *                        Lower values make output more focused and deterministic,
-     *                        higher values make it more creative and varied.
-     * @param req.maxTokens Optional. The maximum number of tokens to generate in the response.
-     *                      Controls the length of the AI's output.
-     *
-     * @returns A promise that resolves to an object containing the AI-generated response.
-     * @returns {string} content The text content of the AI's response.
-     *
-     * @throws An error object if the API request fails.
-     *
-     * @example
-     * ```typescript
-     * const response = await client.ai.chat({
-     *   model: "gpt-4o",
-     *   systemPrompt: "You are a helpful coding assistant.",
-     *   userPrompt: "Explain what TypeScript is in one sentence.",
-     *   temperature: 0.7,
-     *   maxTokens: 100
-     * });
-     * console.log(response.content);
-     * ```
-     */
-    async chat(req) {
-        const res = await fetch(`${this.client.apiUrl}/ai/chat`, {
-            method: "POST",
-            headers: this.client.apiHeaders,
-            body: JSON.stringify(req),
-        });
-        if (!res.ok) {
-            throw await res.json();
-        }
-        return await res.json();
-    }
-    /**
-     * Generate structured JSON output from the AI model.
-     *
-     * Sends a chat request to the AI service with the expectation of receiving
-     * a JSON-formatted response. This is useful for scenarios where the output
-     * needs to be parsed or processed programmatically.
-     *
-     * @param req The chat request parameters.
-     * @param req.model Optional. The AI model to use. Defaults to server-side default if not specified.
-     *                  Available models:
-     *                  - `gpt-4o`: OpenAI GPT-4 Optimized
-     *                  - `gpt-4o-mini`: Smaller, faster GPT-4 variant
-     *                  - `gpt-5`: OpenAI GPT-5 (latest)
-     *                  - `gpt-5-mini`: Smaller GPT-5 variant
-     *                  - `gpt-5-nano`: Smallest GPT-5 variant for lightweight tasks
-     *                  - `gemini-2.5-flash-lite`: Google Gemini lite variant
-     *                  - `gemini-2.5-flash`: Google Gemini fast variant
-     * @param req.systemPrompt Optional. The system message that sets the behavior and context for the AI.
-     *                         This helps define the AI's role, personality, and constraints.
-     * @param req.userPrompt The user's message or question to send to the AI.
-     * @param req.temperature Optional. Controls randomness in the response (0.0 to 1.0).
-     *                        Lower values make output more focused and deterministic,
-     *                        higher values make it more creative and varied.
-     * @param req.maxTokens Optional. The maximum number of tokens to generate in the response.
-     *                      Controls the length of the AI's output.
-     *
-     * @returns A promise that resolves to the parsed JSON object generated by the AI.
-     *
-     * @throws An error object if the API request fails or if the response is not valid JSON.
-     */
-    async generateJson(req) {
-        const { content } = await this.chat({
-            ...req,
-            responseMimeType: "application/json",
-        });
-        return JSON.parse(content);
-    }
-    /**
-     * Modify an image using the AI service.
-     * @param baseImageUrl The URL of the base image to modify.
-     * @param prompt The modification prompt to apply to the image.
-     * @param tags Optional. Tags to associate with the image.
-     * @returns A promise that resolves to the modified image upload information.
-     */
-    async modifyImage(baseImageUrl, prompt, tags = []) {
-        const res = await fetch(`${this.client.apiUrl}/ai/modify-image`, {
-            method: "POST",
-            headers: this.client.apiHeaders,
-            body: JSON.stringify({ baseImageUrl, prompt, tags }),
-        });
-        if (!res.ok) {
-            throw await res.json();
-        }
-        return await res.json();
-    }
-}

package/dist/kokimoki-awareness.d.ts

@@ -1,21 +0,0 @@
-import { KokimokiStore } from "./kokimoki-store";
-import { RoomSubscriptionMode } from "./room-subscription-mode";
-import type { KokimokiClient } from "./kokimoki-client";
-import type { Snapshot } from "valtio/vanilla";
-export declare class KokimokiAwareness<DataT> extends KokimokiStore<{
-  [connectionId: string]: {
-    clientId: string;
-    data: DataT;
-  };
-}> {
-  private _data;
-  private _kmClients;
-  constructor(roomName: string, _data: DataT, mode?: RoomSubscriptionMode);
-  onJoin(client: KokimokiClient<any>): Promise<void>;
-  onBeforeLeave(client: KokimokiClient): Promise<void>;
-  onLeave(client: KokimokiClient<any>): Promise<void>;
-  getClients(): {
-    [clientId: string]: Snapshot<DataT>;
-  };
-  setData(data: DataT): Promise<void>;
-}

package/dist/kokimoki-awareness.js

@@ -1,48 +0,0 @@
-import { KokimokiStore } from "./kokimoki-store";
-import { RoomSubscriptionMode } from "./room-subscription-mode";
-export class KokimokiAwareness extends KokimokiStore {
-  _data;
-  _kmClients = new Set();
-  constructor(roomName, _data, mode = RoomSubscriptionMode.ReadWrite) {
-    super(`/a/${roomName}`, {}, mode);
-    this._data = _data;
-  }
-  async onJoin(client) {
-    this._kmClients.add(client);
-    await client.transact([this], ([state]) => {
-      state[client.connectionId] = {
-        clientId: client.id,
-        data: this._data,
-      };
-    });
-  }
-  async onBeforeLeave(client) {
-    console.log("Awareness: onBeforeLeave", client.connectionId);
-    await client.transact([this], ([state]) => {
-      delete state[client.connectionId];
-    });
-  }
-  async onLeave(client) {
-    this._kmClients.delete(client);
-  }
-  getClients() {
-    const clients = {};
-    const connections = this.get();
-    for (const connectionId in connections) {
-      clients[connections[connectionId].clientId] =
-        connections[connectionId].data;
-    }
-    return clients;
-  }
-  async setData(data) {
-    this._data = data;
-    const kmClients = Array.from(this._kmClients);
-    await Promise.all(
-      kmClients.map(async (client) => {
-        await client.transact([this], ([state]) => {
-          state[client.connectionId].data = this._data;
-        });
-      }),
-    );
-  }
-}

package/dist/kokimoki-client-refactored.d.ts

@@ -1,80 +0,0 @@
-import type TypedEmitter from "typed-emitter";
-import type { KokimokiClientEventsRefactored } from "./types/events";
-import type { Upload } from "./types/upload";
-import type { Paginated } from "./types/common";
-import { KokimokiTransaction } from "./kokimoki-transaction";
-import type { KokimokiStore } from "./kokimoki-store";
-import type { SyncedGeneric } from "./synced-schema";
-import { RoomSubscriptionMode } from "./room-subscription-mode";
-declare const KokimokiClientRefactored_base: new () => TypedEmitter<KokimokiClientEventsRefactored>;
-export declare class KokimokiClientRefactored<
-  ClientContextT = any,
-> extends KokimokiClientRefactored_base {
-  readonly host: string;
-  readonly appId: string;
-  readonly code: string;
-  private _wsUrl;
-  private _apiUrl;
-  private _id?;
-  private _token?;
-  private _apiHeaders?;
-  private _serverTimeOffset;
-  private _clientContext?;
-  private _ws?;
-  private _subscriptions;
-  private _stores;
-  private _reqPromises;
-  private _transactionResolves;
-  private _roomHashes;
-  private _roomHashToDoc;
-  private _connected;
-  private _connectPromise?;
-  private _messageId;
-  constructor(host: string, appId: string, code?: string);
-  get id(): string;
-  get token(): string;
-  get apiUrl(): string;
-  get apiHeaders(): Headers;
-  get clientContext(): ClientContextT & ({} | null);
-  get connected(): boolean;
-  get ws(): WebSocket;
-  connect(): Promise<void>;
-  private handleInitMessage;
-  private handleBinaryMessage;
-  private handleErrorMessage;
-  private handleSubscribeResMessage;
-  private handleRoomUpdateMessage;
-  serverTimestamp(): number;
-  patchRoomState(room: string, update: Uint8Array): Promise<any>;
-  private createUpload;
-  private uploadChunks;
-  private completeUpload;
-  upload(name: string, blob: Blob, tags?: string[]): Promise<Upload>;
-  updateUpload(
-    id: string,
-    update: {
-      tags?: string[];
-    },
-  ): Promise<Upload>;
-  listUploads(
-    filter?: {
-      clientId?: string;
-      mimeTypes?: string[];
-      tags?: string[];
-    },
-    skip?: number,
-    limit?: number,
-  ): Promise<Paginated<Upload>>;
-  deleteUpload(id: string): Promise<{
-    acknowledged: boolean;
-    deletedCount: number;
-  }>;
-  exposeScriptingContext(context: any): Promise<void>;
-  private sendSubscriptionReq;
-  join<T extends SyncedGeneric<unknown>>(
-    store: KokimokiStore<T>,
-    mode?: RoomSubscriptionMode,
-  ): Promise<void>;
-  transact(handler: (t: KokimokiTransaction) => void): Promise<void>;
-}
-export {};