@kokimoki/app 1.17.0 → 2.0.1

package/dist/core/room-subscription-mode.d.ts

@@ -0,0 +1,5 @@
+export declare enum RoomSubscriptionMode {
+    Read = "r",
+    Write = "w",
+    ReadWrite = "b"
+}

package/dist/core/room-subscription-mode.js

@@ -0,0 +1,6 @@
+export var RoomSubscriptionMode;
+(function (RoomSubscriptionMode) {
+    RoomSubscriptionMode["Read"] = "r";
+    RoomSubscriptionMode["Write"] = "w";
+    RoomSubscriptionMode["ReadWrite"] = "b";
+})(RoomSubscriptionMode || (RoomSubscriptionMode = {}));

package/dist/core/room-subscription.d.ts

@@ -0,0 +1,15 @@
+import type { KokimokiStore } from "../stores";
+import type { KokimokiClient } from "./kokimoki-client";
+export declare class RoomSubscription {
+    private kmClient;
+    readonly store: KokimokiStore<any>;
+    private _joined;
+    private _roomHash?;
+    private _onDisconnect;
+    constructor(kmClient: KokimokiClient, store: KokimokiStore<any>);
+    get roomName(): string;
+    get roomHash(): number;
+    get joined(): boolean;
+    applyInitialResponse(roomHash: number, initialUpdate?: Uint8Array): Promise<void>;
+    close(): void;
+}

package/dist/core/room-subscription.js

@@ -0,0 +1,53 @@
+import * as Y from "yjs";
+import { RoomSubscriptionMode } from "./room-subscription-mode";
+export class RoomSubscription {
+    kmClient;
+    store;
+    _joined = false;
+    _roomHash;
+    _onDisconnect = () => {
+        this._joined = false;
+    };
+    constructor(kmClient, store) {
+        this.kmClient = kmClient;
+        this.store = store;
+        kmClient.on("disconnected", this._onDisconnect);
+    }
+    get roomName() {
+        return this.store.roomName;
+    }
+    get roomHash() {
+        if (!this._roomHash) {
+            throw new Error("Room not joined");
+        }
+        return this._roomHash;
+    }
+    get joined() {
+        return this._joined;
+    }
+    async applyInitialResponse(roomHash, initialUpdate) {
+        this._roomHash = roomHash;
+        // Apply initial state
+        if (initialUpdate) {
+            Y.applyUpdate(this.store.doc, initialUpdate, this);
+        }
+        // Set defaults if doc is empty after sync (only possible in ReadWrite mode)
+        if (this.store.mode === RoomSubscriptionMode.ReadWrite) {
+            await this.kmClient.transact([this.store], ([state]) => {
+                if (!("_connections" in state)) {
+                    state._connections = {};
+                }
+                for (const key in this.store.defaultValue) {
+                    // eslint-disable-next-line no-prototype-builtins
+                    if (!state.hasOwnProperty(key)) {
+                        state[key] = this.store.defaultValue[key];
+                    }
+                }
+            });
+        }
+        this._joined = true;
+    }
+    close() {
+        this.kmClient.off("disconnected", this._onDisconnect);
+    }
+}

package/dist/fields.d.ts

@@ -0,0 +1,110 @@
+export interface FieldOptions {
+  label?: string;
+}
+export declare abstract class Field<T> {
+  readonly options: FieldOptions;
+  constructor(options: FieldOptions);
+  abstract get value(): T;
+  abstract get schema(): any;
+}
+export declare class BooleanField extends Field<boolean> {
+  value: boolean;
+  constructor(value: boolean, options?: FieldOptions);
+  get schema(): {
+    type: string;
+    default: boolean;
+  };
+}
+export declare class ConstField<T extends string> extends Field<
+  string extends T ? never : T
+> {
+  value: string extends T ? never : T;
+  constructor(value: string extends T ? never : T, options?: FieldOptions);
+  get schema(): {
+    const: string extends T ? never : T;
+  };
+}
+export declare class ImageField extends Field<string> {
+  value: string;
+  constructor(value: string, options?: FieldOptions);
+  get schema(): {
+    type: string;
+    default: string;
+  };
+}
+export declare class TextField extends Field<string> {
+  value: string;
+  constructor(value: string, options?: FieldOptions);
+  get schema(): {
+    type: string;
+    default: string;
+  };
+}
+export declare class EnumField<T extends Record<string, string>> extends Field<
+  keyof T
+> {
+  enumValues: T;
+  value: keyof T;
+  constructor(enumValues: T, value: keyof T, options?: FieldOptions);
+  get schema(): {
+    enum: string[];
+  };
+}
+export declare class IntegerField extends Field<number> {
+  value: number;
+  constructor(value: number, options?: FieldOptions);
+  get schema(): {
+    type: string;
+    default: number;
+  };
+}
+export declare class FloatField extends Field<number> {
+  value: number;
+  constructor(value: number, options?: FieldOptions);
+  get schema(): {
+    type: string;
+    default: number;
+  };
+}
+export declare class FormGroup<
+  T extends Record<string, Field<any>>,
+  O extends Record<string, Field<any>>,
+> extends Field<
+  {
+    [key in keyof T]: T[key]["value"];
+  } & Partial<{
+    [key in keyof O]: O[key]["value"];
+  }>
+> {
+  requiredFields: T;
+  optionalFields: O;
+  constructor(requiredFields: T, optionalFields?: O, options?: FieldOptions);
+  get value(): {
+    [key in keyof T]: T[key]["value"];
+  } & Partial<{
+    [key in keyof O]: O[key]["value"];
+  }>;
+  get schema(): {
+    type: string;
+    properties: any;
+    required: string[];
+  };
+}
+export declare class FormArray<T> extends Field<T[]> {
+  private factory;
+  value: Field<T>["value"][];
+  constructor(
+    factory: () => Field<T>,
+    value: Field<T>["value"][],
+    options?: FieldOptions,
+  );
+  get schema(): {
+    type: string;
+    items: any;
+    default: T[];
+  };
+}
+export declare class Form<
+  R extends Record<string, Field<any>>,
+  O extends Record<string, Field<any>>,
+> extends FormGroup<R, O> {}

package/dist/fields.js

@@ -0,0 +1,158 @@
+const defaultFieldOptions = {};
+export class Field {
+  options;
+  constructor(options) {
+    this.options = options;
+  }
+}
+export class BooleanField extends Field {
+  value;
+  constructor(value, options = defaultFieldOptions) {
+    super(options);
+    this.value = value;
+  }
+  get schema() {
+    return {
+      type: "boolean",
+      default: this.value,
+    };
+  }
+}
+export class ConstField extends Field {
+  value;
+  constructor(value, options = defaultFieldOptions) {
+    super(options);
+    this.value = value;
+  }
+  get schema() {
+    return {
+      const: this.value,
+    };
+  }
+}
+export class ImageField extends Field {
+  value;
+  constructor(value, options = defaultFieldOptions) {
+    super(options);
+    this.value = value;
+  }
+  get schema() {
+    return {
+      type: "string",
+      default: this.value,
+    };
+  }
+}
+export class TextField extends Field {
+  value;
+  constructor(value, options = defaultFieldOptions) {
+    super(options);
+    this.value = value;
+  }
+  get schema() {
+    return {
+      type: "string",
+      default: this.value,
+    };
+  }
+}
+export class EnumField extends Field {
+  enumValues;
+  value;
+  constructor(enumValues, value, options = defaultFieldOptions) {
+    super(options);
+    this.enumValues = enumValues;
+    this.value = value;
+  }
+  get schema() {
+    return {
+      enum: Object.keys(this.enumValues),
+    };
+  }
+}
+export class IntegerField extends Field {
+  value;
+  constructor(value, options = defaultFieldOptions) {
+    super(options);
+    this.value = value;
+  }
+  get schema() {
+    return {
+      type: "integer",
+      default: this.value,
+    };
+  }
+}
+export class FloatField extends Field {
+  value;
+  constructor(value, options = defaultFieldOptions) {
+    super(options);
+    this.value = value;
+  }
+  get schema() {
+    return {
+      type: "number",
+      default: this.value,
+    };
+  }
+}
+export class FormGroup extends Field {
+  requiredFields;
+  optionalFields;
+  constructor(
+    requiredFields,
+    optionalFields = {},
+    options = defaultFieldOptions,
+  ) {
+    super(options);
+    this.requiredFields = requiredFields;
+    this.optionalFields = optionalFields;
+  }
+  get value() {
+    const value = Object.entries(this.requiredFields).reduce(
+      (acc, [key, field]) => {
+        acc[key] = field.value;
+        return acc;
+      },
+      {},
+    );
+    Object.entries(this.optionalFields).forEach(([key, field]) => {
+      if (field.value !== undefined) {
+        value[key] = field.value;
+      }
+    });
+    return value;
+  }
+  get schema() {
+    const properties = {};
+    Object.entries(this.requiredFields).forEach(([key, field]) => {
+      properties[key] = field.schema;
+    });
+    Object.entries(this.optionalFields).forEach(([key, field]) => {
+      properties[key] = field.schema;
+    });
+    return {
+      type: "object",
+      properties,
+      required: Object.keys(this.requiredFields),
+    };
+  }
+}
+export class FormArray extends Field {
+  factory;
+  value;
+  constructor(factory, value, options = defaultFieldOptions) {
+    super(options);
+    this.factory = factory;
+    this.value = value;
+  }
+  get schema() {
+    const field = this.factory();
+    return {
+      type: "array",
+      items: field.schema,
+      default: this.value,
+    };
+  }
+}
+export class Form extends FormGroup {}

package/dist/index.d.ts

@@ -1,8 +1,4 @@
-export * from "./types/common";
-export * from "./types/events";
-export * from "./types/upload";
-export * from "./kokimoki-client";
-export * from "./kokimoki-store";
-export * from "./room-subscription";
-export * from "./room-subscription-mode";
-export * from "./kokimoki-awareness";
+export { KokimokiClient } from "./core";
+export { KokimokiStore } from "./stores";
+export type { KokimokiClientEvents, Paginated, Upload } from "./types";
+export * from "./utils/valtio";

package/dist/index.js

@@ -1,9 +1,4 @@
-export * from "./types/common";
-export * from "./types/events";
-export * from "./types/upload";
-export * from "./kokimoki-client";
-export * from "./kokimoki-store";
-// export * from "./kokimoki-queue";
-export * from "./room-subscription";
-export * from "./room-subscription-mode";
-export * from "./kokimoki-awareness";
+export { KokimokiClient } from "./core";
+export { KokimokiStore } from "./stores";
+// Re-export Valtio utilities
+export * from "./utils/valtio";

package/dist/kokimoki-ai.d.ts

@@ -0,0 +1,153 @@
+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

@@ -0,0 +1,164 @@
+/**
+ * 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();
+    }
+}