@kokimoki/app 3.1.2 → 3.1.4

package/dist/services/kokimoki-ai.d.ts

@@ -1,16 +1,15 @@
-import { z, ZodType } from "zod/v4";
+import { ZodType } from "zod/v4";
 import { KokimokiClient } from "../core";
-import type { PollOptions, Upload } from "../types";
 /** AI job status */
 export type AiJobStatus = "processing" | "queued" | "completed" | "failed";
 /** AI job type */
 export type AiJobType = "text" | "json" | "image";
 /** AI job information */
-export interface AiJob {
+export interface AiJob<T = unknown> {
     jobId: string;
     type: AiJobType;
     status: AiJobStatus;
-    result?: unknown;
+    result?: T;
     error?: {
         message: string;
         code?: string;
@@ -109,7 +108,7 @@ export declare class KokimokiAiService {
      * Generate text content from the AI model.
      *
      * Submits a text generation job and returns immediately with a jobId.
-     * Use `pollText()` to wait for the result.
+     * Use `getJob()` to poll for the result.
      *
      * @param req The generation request parameters.
      * @returns A promise that resolves to an object containing the jobId.
@@ -122,7 +121,8 @@ export declare class KokimokiAiService {
      *   temperature: 0.8
      * });
      *
-     * const text = await kmClient.ai.pollText(jobId);
+     * const job = await kmClient.ai.getJob<string>(jobId);
+     * console.log('Generated quest:', job.result);
      * ```
      */
     generateText(req: TextGenerateRequest): Promise<JobSubmitResponse>;
@@ -131,7 +131,7 @@ export declare class KokimokiAiService {
      *
      * Submits a JSON generation job and returns immediately with a jobId.
      * The Zod schema is converted to JSON Schema and sent to the AI.
-     * Use `pollJson()` to wait for the result with type inference.
+     * Use `getJob()` to poll for the result with type inference.
      *
      * @param req The generation request parameters including Zod schema.
      * @returns A promise that resolves to an object containing the jobId.
@@ -144,13 +144,16 @@ export declare class KokimokiAiService {
      *   attack: z.number()
      * });
      *
+     * type Enemy = z.infer<typeof enemySchema>;
+     *
      * const { jobId } = await kmClient.ai.generateJson({
      *   schema: enemySchema,
      *   prompt: 'Create a level 5 goblin warrior'
      * });
      *
      * // Poll with schema for type inference and validation
-     * const enemy = await kmClient.ai.pollJson(jobId, { schema: enemySchema });
+     * const job = await kmClient.ai.getJob<Enemy>(jobId);
+     * console.log('Generated enemy:', job.result);
      * ```
      */
     generateJson<T extends ZodType>(req: JsonGenerateRequest<T>): Promise<JobSubmitResponse>;
@@ -158,7 +161,7 @@ export declare class KokimokiAiService {
      * Generate or modify an image using the AI model.
      *
      * Submits an image generation job and returns immediately with a jobId.
-     * Use `pollImage()` to wait for the result.
+     * Use `getJob()` to poll for the result.
      *
      * @param req The generation request parameters.
      * @returns A promise that resolves to an object containing the jobId.
@@ -171,7 +174,8 @@ export declare class KokimokiAiService {
      *   prompt: 'Make it look like pixel art'
      * });
      *
-     * const image = await kmClient.ai.pollImage(jobId);
+     * const job = await kmClient.ai.getJob<string>(jobId);
+     * console.log('Generated image:', job.result);
      * ```
      */
     generateImage(req: ImageGenerateRequest): Promise<JobSubmitResponse>;
@@ -183,48 +187,6 @@ export declare class KokimokiAiService {
      * @param jobId The job ID to check.
      * @returns A promise that resolves to the job information.
      */
-    getJob(jobId: string): Promise<AiJob>;
-    /**
-     * Poll a text generation job until completion.
-     *
-     * @param jobId The job ID to poll.
-     * @param options Polling options (interval, timeout, progress callback).
-     * @returns A promise that resolves to the generated text.
-     * @throws If the job fails or times out.
-     */
-    pollText(jobId: string, options?: PollOptions<AiJobStatus>): Promise<string>;
-    /**
-     * Poll a JSON generation job until completion.
-     *
-     * @param jobId The job ID to poll.
-     * @param options Polling options including the Zod schema for validation.
-     * @returns A promise that resolves to the parsed and validated JSON.
-     * @throws If the job fails, times out, or validation fails.
-     *
-     * @example
-     * ```typescript
-     * const enemy = await kmClient.ai.pollJson(savedJobId, {
-     *   schema: enemySchema,
-     *   timeout: 60000,
-     *   onProgress: (status) => console.log('Status:', status)
-     * });
-     * ```
-     */
-    pollJson<T extends ZodType>(jobId: string, options: PollOptions<AiJobStatus> & {
-        schema: T;
-    }): Promise<z.infer<T>>;
-    /**
-     * Poll an image generation job until completion.
-     *
-     * @param jobId The job ID to poll.
-     * @param options Polling options (interval, timeout, progress callback).
-     * @returns A promise that resolves to the upload information.
-     * @throws If the job fails or times out.
-     */
-    pollImage(jobId: string, options?: PollOptions<AiJobStatus>): Promise<Upload>;
-    /**
-     * Internal polling implementation.
-     */
-    private pollJob;
+    getJob<T = unknown>(jobId: string): Promise<AiJob<T>>;
 }
 export {};

package/dist/services/kokimoki-ai.js

@@ -58,7 +58,7 @@ export class KokimokiAiService {
      * Generate text content from the AI model.
      *
      * Submits a text generation job and returns immediately with a jobId.
-     * Use `pollText()` to wait for the result.
+     * Use `getJob()` to poll for the result.
      *
      * @param req The generation request parameters.
      * @returns A promise that resolves to an object containing the jobId.
@@ -71,7 +71,8 @@ export class KokimokiAiService {
      *   temperature: 0.8
      * });
      *
-     * const text = await kmClient.ai.pollText(jobId);
+     * const job = await kmClient.ai.getJob<string>(jobId);
+     * console.log('Generated quest:', job.result);
      * ```
      */
     async generateText(req) {
@@ -93,7 +94,7 @@ export class KokimokiAiService {
      *
      * Submits a JSON generation job and returns immediately with a jobId.
      * The Zod schema is converted to JSON Schema and sent to the AI.
-     * Use `pollJson()` to wait for the result with type inference.
+     * Use `getJob()` to poll for the result with type inference.
      *
      * @param req The generation request parameters including Zod schema.
      * @returns A promise that resolves to an object containing the jobId.
@@ -106,13 +107,16 @@ export class KokimokiAiService {
      *   attack: z.number()
      * });
      *
+     * type Enemy = z.infer<typeof enemySchema>;
+     *
      * const { jobId } = await kmClient.ai.generateJson({
      *   schema: enemySchema,
      *   prompt: 'Create a level 5 goblin warrior'
      * });
      *
      * // Poll with schema for type inference and validation
-     * const enemy = await kmClient.ai.pollJson(jobId, { schema: enemySchema });
+     * const job = await kmClient.ai.getJob<Enemy>(jobId);
+     * console.log('Generated enemy:', job.result);
      * ```
      */
     async generateJson(req) {
@@ -136,7 +140,7 @@ export class KokimokiAiService {
      * Generate or modify an image using the AI model.
      *
      * Submits an image generation job and returns immediately with a jobId.
-     * Use `pollImage()` to wait for the result.
+     * Use `getJob()` to poll for the result.
      *
      * @param req The generation request parameters.
      * @returns A promise that resolves to an object containing the jobId.
@@ -149,7 +153,8 @@ export class KokimokiAiService {
      *   prompt: 'Make it look like pixel art'
      * });
      *
-     * const image = await kmClient.ai.pollImage(jobId);
+     * const job = await kmClient.ai.getJob<string>(jobId);
+     * console.log('Generated image:', job.result);
      * ```
      */
     async generateImage(req) {
@@ -169,9 +174,6 @@ export class KokimokiAiService {
         }
         return await res.json();
     }
-    // ============================================================
-    // Job Status & Polling Methods
-    // ============================================================
     /**
      * Get the current status of an AI job.
      *
@@ -190,77 +192,4 @@ export class KokimokiAiService {
         }
         return await res.json();
     }
-    /**
-     * Poll a text generation job until completion.
-     *
-     * @param jobId The job ID to poll.
-     * @param options Polling options (interval, timeout, progress callback).
-     * @returns A promise that resolves to the generated text.
-     * @throws If the job fails or times out.
-     */
-    async pollText(jobId, options) {
-        const result = await this.pollJob(jobId, options);
-        return result;
-    }
-    /**
-     * Poll a JSON generation job until completion.
-     *
-     * @param jobId The job ID to poll.
-     * @param options Polling options including the Zod schema for validation.
-     * @returns A promise that resolves to the parsed and validated JSON.
-     * @throws If the job fails, times out, or validation fails.
-     *
-     * @example
-     * ```typescript
-     * const enemy = await kmClient.ai.pollJson(savedJobId, {
-     *   schema: enemySchema,
-     *   timeout: 60000,
-     *   onProgress: (status) => console.log('Status:', status)
-     * });
-     * ```
-     */
-    async pollJson(jobId, options) {
-        const { schema, ...pollOptions } = options;
-        const result = await this.pollJob(jobId, pollOptions);
-        return schema.parse(result);
-    }
-    /**
-     * Poll an image generation job until completion.
-     *
-     * @param jobId The job ID to poll.
-     * @param options Polling options (interval, timeout, progress callback).
-     * @returns A promise that resolves to the upload information.
-     * @throws If the job fails or times out.
-     */
-    async pollImage(jobId, options) {
-        const result = await this.pollJob(jobId, options);
-        return result;
-    }
-    /**
-     * Internal polling implementation.
-     */
-    async pollJob(jobId, options) {
-        const pollInterval = Math.max(1000, options?.pollInterval ?? 2000);
-        const timeout = options?.timeout ?? 120000;
-        const startTime = Date.now();
-        while (true) {
-            const job = await this.getJob(jobId);
-            // Call progress callback
-            options?.onProgress?.(job.status);
-            if (job.status === "completed") {
-                return job.result;
-            }
-            if (job.status === "failed") {
-                throw new Error(job.error?.message ?? "AI job failed");
-            }
-            // processing and queued both continue polling
-            // queued jobs will be promoted when slots become available
-            // Check timeout
-            if (Date.now() - startTime > timeout) {
-                throw new Error(`AI job timed out after ${timeout}ms`);
-            }
-            // Wait before next poll
-            await new Promise((resolve) => setTimeout(resolve, pollInterval));
-        }
-    }
 }

package/dist/services/kokimoki-i18n.d.ts

@@ -1,6 +1,5 @@
 import i18next, { type i18n } from "i18next";
 import type { KokimokiClient } from "../core";
-import type { PollOptions } from "../types";
 /**
  * Options for creating an i18n instance.
  */
@@ -15,39 +14,7 @@ export interface I18nOptions {
 /**
  * Status of a single namespace translation.
  */
-export type NamespaceStatus = "available" | "processing" | "failed" | "not_available";
-/**
- * Aggregated status of a language across all namespaces.
- */
-export type LanguageStatus = "available" | "processing" | "failed" | "partial";
-/**
- * Translation status for a specific language.
- */
-export interface TranslationStatus {
-    /** Overall status of the language */
-    status: "available" | "processing" | "not_available";
-    /** Status per namespace */
-    namespaces: Record<string, NamespaceStatus>;
-}
-/**
- * Status of all languages that have been requested.
- */
-export interface AllLanguagesStatus {
-    /** Array of language statuses */
-    languages: {
-        lng: string;
-        status: LanguageStatus;
-    }[];
-}
-/**
- * Result of requesting a translation.
- */
-export interface RequestTranslationResult {
-    /** Language code that was requested */
-    lng: string;
-    /** Status of the request */
-    status: "started" | "already_processing" | "already_available";
-}
+export type TranslationStatus = "available" | "processing" | "failed";
 /**
  * Kokimoki i18n Service
  *
@@ -61,7 +28,7 @@ export interface RequestTranslationResult {
  * - Pre-configured i18next instance creation
  * - Consistent HTTP-based loading in dev and prod
  * - URL resolution for translation namespaces
- * - AI-powered translation requests with polling support
+ * - AI-powered translation requests and status polling
  *
  * Access via `kmClient.i18n`
  *
@@ -75,16 +42,20 @@ export interface RequestTranslationResult {
  * });
  *
  * // Initialize with primary language
- * await kmClient.i18n.init('en');
+ * await kmClient.i18n.init();
  *
  * // Request AI translation and wait for it
  * await kmClient.i18n.requestTranslation('de');
- * await kmClient.i18n.pollTranslation('de', {
- *   onProgress: (status) => console.log('Translation status:', status.status)
- * });
  *
- * // Now safe to switch language
- * i18next.changeLanguage('de');
+ * // Poll until ready
+ * const checkInterval = setInterval(async () => {
+ *  const status = await kmClient.i18n.getTranslationStatus('de');
+ *  if (status.status === 'available') {
+ *    clearInterval(checkInterval);
+ *    // Now safe to switch language
+ *    i18next.changeLanguage('de');
+ *  }
+ * }, 2000);
  * ```
  */
 export declare class KokimokiI18nService {
@@ -174,17 +145,25 @@ export declare class KokimokiI18nService {
      */
     getLanguages(): string[];
     /**
-     * Get the status of all languages that have been requested for AI translation.
+     * Request AI translation for a target language.
+     *
+     * Triggers background AI translation jobs for all namespaces that are not yet available.
+     * Uses the build's configured primary language as the source.
      *
-     * @returns Promise with array of language statuses
+     * @param lng - Target language code (e.g., 'de', 'fr', 'es')
+     * @returns Promise with the translation status
      *
      * @example
      * ```typescript
-     * const { languages } = await kmClient.i18n.getAllLanguagesStatus();
-     * // [{ lng: 'de', status: 'available' }, { lng: 'fr', status: 'processing' }]
+     * const status = await kmClient.i18n.requestTranslation('de');
+     *
+     * if (status === 'available') {
+     *   // Already translated, switch immediately
+     *   i18next.changeLanguage('de');
+     * }
      * ```
      */
-    getAllLanguagesStatus(): Promise<AllLanguagesStatus>;
+    requestTranslation(lng: string): Promise<TranslationStatus>;
     /**
      * Get the translation status for a specific language.
      *
@@ -208,55 +187,4 @@ export declare class KokimokiI18nService {
      * ```
      */
     getTranslationStatus(lng: string): Promise<TranslationStatus>;
-    /**
-     * Request AI translation for a target language.
-     *
-     * Triggers background AI translation jobs for all namespaces that are not yet available.
-     * Uses the build's configured primary language as the source.
-     *
-     * @param lng - Target language code (e.g., 'de', 'fr', 'es')
-     * @returns Promise with the result of the request
-     *
-     * @example
-     * ```typescript
-     * const result = await kmClient.i18n.requestTranslation('de');
-     *
-     * if (result.status === 'already_available') {
-     *   // Already translated, switch immediately
-     *   i18next.changeLanguage('de');
-     * } else {
-     *   // Poll until ready
-     *   await kmClient.i18n.pollTranslation('de', {
-     *     onProgress: (status) => console.log('Status:', status.status)
-     *   });
-     *   i18next.changeLanguage('de');
-     * }
-     * ```
-     */
-    requestTranslation(lng: string): Promise<RequestTranslationResult>;
-    /**
-     * Poll a translation request until all namespaces are available.
-     *
-     * @param lng - The language code to poll for.
-     * @param options - Polling options (interval, timeout, progress callback).
-     * @returns Promise that resolves when all namespaces are available.
-     * @throws If the translation fails or times out.
-     *
-     * @example
-     * ```typescript
-     * // Request and poll with progress
-     * await kmClient.i18n.requestTranslation('de');
-     * await kmClient.i18n.pollTranslation('de', {
-     *   timeout: 60000,
-     *   onProgress: (status) => {
-     *     console.log('Overall:', status.status);
-     *     console.log('Namespaces:', status.namespaces);
-     *   }
-     * });
-     *
-     * // Now safe to switch
-     * i18next.changeLanguage('de');
-     * ```
-     */
-    pollTranslation(lng: string, options?: PollOptions<TranslationStatus>): Promise<void>;
 }

package/dist/services/kokimoki-i18n.js

@@ -14,7 +14,7 @@ import { getKmEnv } from "../utils/kokimoki-env";
  * - Pre-configured i18next instance creation
  * - Consistent HTTP-based loading in dev and prod
  * - URL resolution for translation namespaces
- * - AI-powered translation requests with polling support
+ * - AI-powered translation requests and status polling
  *
  * Access via `kmClient.i18n`
  *
@@ -28,16 +28,20 @@ import { getKmEnv } from "../utils/kokimoki-env";
  * });
  *
  * // Initialize with primary language
- * await kmClient.i18n.init('en');
+ * await kmClient.i18n.init();
  *
  * // Request AI translation and wait for it
  * await kmClient.i18n.requestTranslation('de');
- * await kmClient.i18n.pollTranslation('de', {
- *   onProgress: (status) => console.log('Translation status:', status.status)
- * });
  *
- * // Now safe to switch language
- * i18next.changeLanguage('de');
+ * // Poll until ready
+ * const checkInterval = setInterval(async () => {
+ *  const status = await kmClient.i18n.getTranslationStatus('de');
+ *  if (status.status === 'available') {
+ *    clearInterval(checkInterval);
+ *    // Now safe to switch language
+ *    i18next.changeLanguage('de');
+ *  }
+ * }, 2000);
  * ```
  */
 export class KokimokiI18nService {
@@ -208,22 +212,31 @@ export class KokimokiI18nService {
         return getKmEnv().i18nLanguages ?? [];
     }
     /**
-     * Get the status of all languages that have been requested for AI translation.
+     * Request AI translation for a target language.
      *
-     * @returns Promise with array of language statuses
+     * Triggers background AI translation jobs for all namespaces that are not yet available.
+     * Uses the build's configured primary language as the source.
+     *
+     * @param lng - Target language code (e.g., 'de', 'fr', 'es')
+     * @returns Promise with the translation status
      *
      * @example
      * ```typescript
-     * const { languages } = await kmClient.i18n.getAllLanguagesStatus();
-     * // [{ lng: 'de', status: 'available' }, { lng: 'fr', status: 'processing' }]
+     * const status = await kmClient.i18n.requestTranslation('de');
+     *
+     * if (status === 'available') {
+     *   // Already translated, switch immediately
+     *   i18next.changeLanguage('de');
+     * }
      * ```
      */
-    async getAllLanguagesStatus() {
-        const res = await fetch(`${this.client.apiUrl}/i18n`, {
-            method: "GET",
+    async requestTranslation(lng) {
+        const res = await fetch(`${this.client.apiUrl}/i18n/${encodeURIComponent(lng)}/translate`, {
+            method: "POST",
             headers: this.client.apiHeaders,
         });
-        return await res.json();
+        const { status } = await res.json();
+        return status;
     }
     /**
      * Get the translation status for a specific language.
@@ -252,89 +265,7 @@ export class KokimokiI18nService {
             method: "GET",
             headers: this.client.apiHeaders,
         });
-        return await res.json();
-    }
-    /**
-     * Request AI translation for a target language.
-     *
-     * Triggers background AI translation jobs for all namespaces that are not yet available.
-     * Uses the build's configured primary language as the source.
-     *
-     * @param lng - Target language code (e.g., 'de', 'fr', 'es')
-     * @returns Promise with the result of the request
-     *
-     * @example
-     * ```typescript
-     * const result = await kmClient.i18n.requestTranslation('de');
-     *
-     * if (result.status === 'already_available') {
-     *   // Already translated, switch immediately
-     *   i18next.changeLanguage('de');
-     * } else {
-     *   // Poll until ready
-     *   await kmClient.i18n.pollTranslation('de', {
-     *     onProgress: (status) => console.log('Status:', status.status)
-     *   });
-     *   i18next.changeLanguage('de');
-     * }
-     * ```
-     */
-    async requestTranslation(lng) {
-        const res = await fetch(`${this.client.apiUrl}/i18n/${encodeURIComponent(lng)}/translate`, {
-            method: "POST",
-            headers: this.client.apiHeaders,
-        });
-        const data = await res.json();
-        return { lng, ...data };
-    }
-    /**
-     * Poll a translation request until all namespaces are available.
-     *
-     * @param lng - The language code to poll for.
-     * @param options - Polling options (interval, timeout, progress callback).
-     * @returns Promise that resolves when all namespaces are available.
-     * @throws If the translation fails or times out.
-     *
-     * @example
-     * ```typescript
-     * // Request and poll with progress
-     * await kmClient.i18n.requestTranslation('de');
-     * await kmClient.i18n.pollTranslation('de', {
-     *   timeout: 60000,
-     *   onProgress: (status) => {
-     *     console.log('Overall:', status.status);
-     *     console.log('Namespaces:', status.namespaces);
-     *   }
-     * });
-     *
-     * // Now safe to switch
-     * i18next.changeLanguage('de');
-     * ```
-     */
-    async pollTranslation(lng, options) {
-        const pollInterval = Math.max(1000, options?.pollInterval ?? 2000);
-        const timeout = options?.timeout ?? 120000;
-        const startTime = Date.now();
-        while (true) {
-            const status = await this.getTranslationStatus(lng);
-            // Call progress callback
-            options?.onProgress?.(status);
-            if (status.status === "available") {
-                return;
-            }
-            // Check for failed namespaces
-            const failedNamespaces = Object.entries(status.namespaces)
-                .filter(([_, ns]) => ns === "failed")
-                .map(([name]) => name);
-            if (failedNamespaces.length > 0) {
-                throw new Error(`Translation failed for namespaces: ${failedNamespaces.join(", ")}`);
-            }
-            // Check timeout
-            if (Date.now() - startTime > timeout) {
-                throw new Error(`Translation timed out after ${timeout}ms`);
-            }
-            // Wait before next poll
-            await new Promise((resolve) => setTimeout(resolve, pollInterval));
-        }
+        const { status } = await res.json();
+        return status;
     }
 }

package/dist/utils/valtio.d.ts

@@ -1,7 +1,4 @@
-import "valtio";
-declare module "valtio" {
-    function useSnapshot<T extends object>(p: T): T;
-}
-export { proxy, ref, snapshot, subscribe, useSnapshot } from "valtio";
+export { proxy, ref, snapshot, subscribe } from "valtio";
+export declare const useSnapshot: <T extends object>(p: T) => T;
 export { derive, underive } from "derive-valtio";
 export { devtools, subscribeKey, useProxy, watch } from "valtio/utils";

package/dist/utils/valtio.js

@@ -1,6 +1,8 @@
-import "valtio";
+import { useSnapshot as _useSnapshot } from "valtio";
 // Core Valtio exports
-export { proxy, ref, snapshot, subscribe, useSnapshot } from "valtio";
+export { proxy, ref, snapshot, subscribe } from "valtio";
+// Loosen useSnapshot return type (valtio returns DeepReadonly<T>, which is too strict)
+export const useSnapshot = _useSnapshot;
 // Valtio utilities
 export { derive, underive } from "derive-valtio";
 export { devtools, subscribeKey, useProxy, watch } from "valtio/utils";

package/dist/version.d.ts

@@ -1 +1 @@
-export declare const KOKIMOKI_APP_VERSION = "3.1.2";
+export declare const KOKIMOKI_APP_VERSION = "3.1.4";

package/dist/version.js

@@ -1,2 +1,2 @@
 // Auto-generated file. Do not edit manually.
-export const KOKIMOKI_APP_VERSION = '3.1.2';
+export const KOKIMOKI_APP_VERSION = '3.1.4';