@kokimoki/app 1.16.2 → 2.0.0

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

@@ -5,4 +5,3 @@ export * from "./kokimoki-client";
 export * from "./kokimoki-store";
 export * from "./room-subscription";
 export * from "./room-subscription-mode";
-export * from "./kokimoki-awareness";

package/dist/index.js

@@ -3,7 +3,5 @@ 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";

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();
+    }
+}

package/dist/kokimoki-awareness.d.ts

@@ -3,18 +3,19 @@ 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;
-    };
+  [connectionId: string]: {
+    clientId: string;
+    data: DataT;
+  };
 }> {
-    private _data;
-    private _kmClients;
-    constructor(roomName: string, _data: DataT, mode?: RoomSubscriptionMode);
-    onJoin(client: KokimokiClient<any>): Promise<void>;
-    onLeave(client: KokimokiClient<any>): Promise<void>;
-    getClients(): {
-        [clientId: string]: Snapshot<DataT>;
-    };
-    setData(data: DataT): Promise<void>;
+  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>;
 }