akanjs 2.2.7 → 2.2.9

package/service/predefinedAdaptor/database.adaptor.ts

@@ -4,7 +4,7 @@ import { mkdir } from "node:fs/promises";
 import path from "node:path";
 import type { InArgs, InValue, Client as LibsqlClient } from "@libsql/client";
 import { type BaseEnv, dayjs, FIELD_META, type PromiseOrObject } from "akanjs/base";
-import type { ConstantModel } from "akanjs/constant";
+import { type ConstantModel, getDefault } from "akanjs/constant";
 import {
   createDocumentId,
   type DatabaseModel,
@@ -300,6 +300,13 @@ const jsonPath = (path: string) =>
     .map((part) => part.replaceAll('"', '\\"'))
     .join(".")}`;
 const encodeSqlValue = (value: unknown) => encodeDocumentValue(value);
+
+const decodeDateValue = (value: unknown) => {
+  if (value === null || value === undefined) return value;
+  if (typeof value === "number") return dayjs(value);
+  const epoch = Number(value);
+  return Number.isNaN(epoch) ? dayjs(value as never) : dayjs(epoch);
+};
 const QUERY_OPERATOR_KEYS = new Set([
   "eq",
   "ne",
@@ -773,6 +780,9 @@ export class SqliteDocumentStore {
       } else {
         doc[key] = value;
       }
+      if (doc[key] !== undefined && doc[key] !== null) {
+        doc[key] = this.normalizeWriteValue(doc[key], props);
+      }
       if (props.enum && doc[key] !== undefined && doc[key] !== null) {
         const values = Array.isArray(doc[key]) ? doc[key] : [doc[key]];
         const fieldEnum = props.enum as { has: (value: unknown) => boolean } | undefined;
@@ -958,12 +968,28 @@ export class SqliteDocumentStore {
 
   private decodeDocumentPayload(payload: Record<string, unknown>) {
     const fields = this.database.doc[FIELD_META] as unknown as FieldMap;
-    return Object.fromEntries(
-      Object.entries(payload).map(([key, value]) => {
-        const props = fields[key]?.getProps?.();
-        return [key, props ? this.decodeFieldValue(value, props) : value];
-      }),
-    );
+    const result: Record<string, unknown> = {};
+    for (const [key, fieldMeta] of Object.entries(fields)) {
+      if (BASE_COLUMNS.has(key)) continue;
+      const props = fieldMeta.getProps();
+      const value = payload[key];
+      if (value === undefined) {
+        const def = props.default;
+        if (def !== undefined && def !== null) {
+          result[key] = typeof def === "function" ? (def as (data: unknown) => unknown)(payload) : def;
+        } else if (props.nullable) {
+          result[key] = null;
+        }
+      } else {
+        result[key] = this.decodeFieldValue(value, props);
+      }
+    }
+    for (const [key, value] of Object.entries(payload)) {
+      if (key in result || BASE_COLUMNS.has(key)) continue;
+      const props = fields[key]?.getProps?.();
+      result[key] = props ? this.decodeFieldValue(value, props) : value;
+    }
+    return result;
   }
 
   private decodeFieldValue(value: unknown, props: Record<string, unknown>): unknown {
@@ -973,8 +999,8 @@ export class SqliteDocumentStore {
       return new Map(entries.map(([key, item]) => [key, this.decodeMapValue(item, props)]));
     }
     if (props.modelRef === Date) {
-      if (Array.isArray(value)) return value.map((item) => (item === null ? item : dayjs(Number(item))));
-      return dayjs(Number(value));
+      if (Array.isArray(value)) return value.map((item) => (item === null ? item : decodeDateValue(item)));
+      return decodeDateValue(value);
     }
     if (Array.isArray(value)) return value.map((item) => this.decodeNestedValue(item, props));
     return this.decodeNestedValue(value, props);
@@ -982,7 +1008,7 @@ export class SqliteDocumentStore {
 
   private decodeMapValue(value: unknown, props: Record<string, unknown>) {
     if (value === undefined || value === null) return value;
-    if (props.of === Date) return dayjs(Number(value));
+    if (props.of === Date) return decodeDateValue(value);
     return value;
   }
 
@@ -991,12 +1017,44 @@ export class SqliteDocumentStore {
     if (!props.isClass || !props.isScalar) return value;
     const scalarFields = (props.modelRef as { [FIELD_META]?: FieldMap } | undefined)?.[FIELD_META];
     if (!scalarFields) return value;
-    return Object.fromEntries(
-      Object.entries(value as Record<string, unknown>).map(([key, nested]) => {
-        const nestedProps = scalarFields[key]?.getProps?.();
-        return [key, nestedProps ? this.decodeFieldValue(nested, nestedProps) : nested];
-      }),
-    );
+    const source = value as Record<string, unknown>;
+    const defaults = getDefault(scalarFields as never) as Record<string, unknown>;
+    const result: Record<string, unknown> = {};
+    for (const [key, fieldMeta] of Object.entries(scalarFields)) {
+      const nestedProps = fieldMeta.getProps();
+      const nested = source[key];
+      result[key] = nested === undefined ? defaults[key] : this.decodeFieldValue(nested, nestedProps);
+    }
+    for (const [key, nested] of Object.entries(source)) {
+      if (!(key in result)) result[key] = nested;
+    }
+    return result;
+  }
+
+  private normalizeWriteValue(value: unknown, props: Record<string, unknown>): unknown {
+    if (value === undefined || value === null) return value;
+    if (props.modelRef === Date) {
+      if (Array.isArray(value))
+        return value.map((item) => (item === null || item === undefined ? item : dayjs(item as never)));
+      return dayjs(value as never);
+    }
+    if (!props.isClass || !props.isScalar) return value;
+    if (Array.isArray(value)) return value.map((item) => this.fillScalarDefaults(item, props));
+    return this.fillScalarDefaults(value, props);
+  }
+
+  private fillScalarDefaults(value: unknown, props: Record<string, unknown>): unknown {
+    if (!value || typeof value !== "object") return value;
+    const scalarFields = (props.modelRef as { [FIELD_META]?: FieldMap } | undefined)?.[FIELD_META];
+    if (!scalarFields) return value;
+    const defaults = getDefault(scalarFields as never) as Record<string, unknown>;
+    const result = { ...(value as Record<string, unknown>) };
+    for (const [key, fieldMeta] of Object.entries(scalarFields)) {
+      const nestedProps = fieldMeta.getProps();
+      if (result[key] === undefined) result[key] = defaults[key];
+      else result[key] = this.normalizeWriteValue(result[key], nestedProps);
+    }
+    return result;
   }
 
   hydrate(data: DocumentRecord, originalData: DocumentRecord = data) {

package/service/predefinedAdaptor/solidCache.adaptor.ts

@@ -14,6 +14,7 @@ import {
 } from "./solidSqlite";
 
 type CacheRow = { value: string | Buffer | null; valueType: SolidValueType; expiresAt: number | null };
+type CacheEntryRow = CacheRow & { subKey: string };
 
 export class SolidCache
   extends adapt("solidCache", ({ env }) => ({
@@ -135,6 +136,28 @@ export class SolidCache
       .run(topic, key, subKey);
   }
 
+  async hkeys(topic: string, key: string): Promise<string[]> {
+    this.#cleanup();
+    const rows = this.#db
+      .query(`SELECT "subKey" FROM "_akan_solid_cache_hash" WHERE "topic" = ? AND "key" = ? ORDER BY "subKey" ASC`)
+      .all(topic, key) as { subKey: string }[];
+    return rows.map((row) => row.subKey);
+  }
+
+  async hentries<T extends string | number | Buffer>(topic: string, key: string): Promise<[string, T][]> {
+    this.#cleanup();
+    const rows = this.#db
+      .query(
+        `SELECT "subKey", "value", "valueType", "expiresAt" FROM "_akan_solid_cache_hash" WHERE "topic" = ? AND "key" = ? ORDER BY "subKey" ASC`,
+      )
+      .all(topic, key) as CacheEntryRow[];
+    return rows.map((row) => [row.subKey, decodeSolidValue<T>(row.valueType, row.value) as T]);
+  }
+
+  async hclear(topic: string, key: string): Promise<void> {
+    this.#db.query(`DELETE FROM "_akan_solid_cache_hash" WHERE "topic" = ? AND "key" = ?`).run(topic, key);
+  }
+
   #cleanup() {
     const now = Date.now();
     this.#db.query(`DELETE FROM "_akan_solid_cache" WHERE "expiresAt" IS NOT NULL AND "expiresAt" <= ?`).run(now);

package/signal/base.signal.ts

@@ -18,11 +18,6 @@ export class BaseEndpoint extends endpoint(srv.base, ({ query, mutation, message
   pingQuery: query(String, { nullable: true })
     .search("id", String)
     .exec((id) => `pingQuery: ${id}`),
-  cleanup: mutation(Boolean).exec(async function () {
-    if (process.env.NODE_ENV !== "test") throw new Error("cleanup is only available in test environment");
-    await this.baseService.cleanup();
-    return true;
-  }),
   wsPing: message(String)
     .msg("data", String, { nullable: true })
     .exec((data) => `wsPing: ${data}`),

package/signal/serializer/fetch.serializer.ts

@@ -64,6 +64,7 @@ export class FetchSerializer {
       args: endpointInfo.args.map(FetchSerializer.#serializeArg),
       returns: FetchSerializer.#serializeReturns(endpointInfo),
       ...(endpointInfo.signalOption.path ? { path: endpointInfo.signalOption.path } : {}),
+      ...(endpointInfo.signalOption.fileUpload ? { fileUpload: true } : {}),
       ...(guards?.length ? { guards } : {}),
     };
   }

package/signal/types.ts

@@ -70,6 +70,8 @@ export interface SignalOption<Response = any, Nullable extends boolean = false,
   middlewares?: MiddlewareCls[];
   prefix?: false | string;
   globalPrefix?: false;
+  /** Marks this mutation as the framework file-upload endpoint (see resolveFileUploadCapability). */
+  fileUpload?: boolean;
 
   scheduleType?: "init" | "destroy" | "cron" | "interval" | "timeout";
   scheduleCron?: string;
@@ -84,6 +86,7 @@ interface SerializedSignalOption {
   prefix?: false | string;
   globalPrefix?: false;
   guards?: string[];
+  fileUpload?: boolean;
 }
 export interface SerializedSlice extends SerializedSignalOption {}
 

package/store/action.ts

@@ -1,5 +1,14 @@
 import { DataList, type Dayjs, FIELD_META, type GetStateObject, type SLICE_META } from "akanjs/base";
-import { capitalize, deepObjectify, type FetchPolicy, isQueryEqual, Logger, lowerlize, pathSet } from "akanjs/common";
+import {
+  capitalize,
+  deepObjectify,
+  type FetchPolicy,
+  isQueryEqual,
+  Logger,
+  lowerlize,
+  pathSet,
+  resolveFileUploadCapability,
+} from "akanjs/common";
 import {
   type BaseInsight,
   type BaseObject,
@@ -277,6 +286,7 @@ export const makeFormSetter = (refName: string, fetch: FetchProxy<any>) => {
   type Light = BaseObject;
   const [fieldName, className] = [refName, capitalize(refName)];
   const modelRef = ConstantRegistry.getDatabase(refName).full;
+  const fileUploadRefName = resolveFileUploadCapability(fetch.serializedSignal)?.refName;
 
   const names = {
     model: fieldName,
@@ -356,7 +366,7 @@ export const makeFormSetter = (refName: string, fetch: FetchProxy<any>) => {
             },
           }
         : {}),
-      ...(field.isClass && ConstantRegistry.getRefName(field.modelRef) === "file"
+      ...(field.isClass && !!fileUploadRefName && ConstantRegistry.getRefName(field.modelRef) === fileUploadRefName
         ? {
             [namesOfField.uploadFieldOnModel]: async function (this: SetGet, fileList: FileList, index?: number) {
               const form = (this.get() as { [key: string]: any })[names.modelForm] as { [key: string]: any };
@@ -383,7 +393,9 @@ export const makeFormSetter = (refName: string, fetch: FetchProxy<any>) => {
                 const intervalKey = setInterval(() => {
                   void (async () => {
                     const currentFile = await (
-                      (fetch as { [key: string]: any }).file as (id: string) => Promise<ProtoFile>
+                      (fetch as { [key: string]: any })[fileUploadRefName as string] as (
+                        id: string,
+                      ) => Promise<ProtoFile>
                     )(file.id);
                     if (field.isArray)
                       this.set((state: { [key: string]: { [key: string]: ProtoFile[] } }) => {

package/store/storeInstance.ts

@@ -1,5 +1,6 @@
 import { ACTION_META, STATE_DERIVED_META, STATE_INIT_META } from "akanjs/base";
-import { capitalize, Logger } from "akanjs/common";
+import { Translator } from "akanjs/client/translator";
+import { capitalize, Logger, parseAkanI18nEnv } from "akanjs/common";
 import { produce } from "immer";
 import type { RefObject } from "react";
 import { useEffect, useRef, useSyncExternalStore } from "./hooks";
@@ -9,6 +10,7 @@ import { evaluateInitializers, type SearchParamsState, type StateDerivedMeta } f
 
 type StoreStateRecord = Record<string, unknown>;
 type StoreAction = (...args: unknown[]) => unknown;
+type TranslationParam = Record<string, string | number>;
 
 type SliceActionKey =
   | "initModel"
@@ -20,6 +22,27 @@ type SliceActionKey =
   | "setQueryArgsOfModel"
   | "setSortOfModel";
 
+const isRecord = (value: unknown): value is Record<string, unknown> =>
+  Boolean(value && typeof value === "object" && !Array.isArray(value));
+
+const getActionErrorKey = (error: unknown) => {
+  if (typeof error === "string") return error;
+  if (!isRecord(error)) return String(error);
+  if (typeof error.error === "string") return error.error;
+  if (typeof error.message === "string") return error.message;
+  return String(error);
+};
+
+const getActionErrorData = (error: unknown): TranslationParam | undefined => {
+  if (!isRecord(error) || !isRecord(error.data)) return undefined;
+  const data = Object.fromEntries(
+    Object.entries(error.data).filter((entry): entry is [string, string | number] =>
+      ["string", "number"].includes(typeof entry[1]),
+    ),
+  );
+  return Object.keys(data).length ? data : undefined;
+};
+
 export type ReactAPI = {
   useSyncExternalStore: <T>(
     subscribe: (onStoreChange: () => void) => () => void,
@@ -190,12 +213,36 @@ export class StoreInstance {
       this.do[k] = async (...args: unknown[]) => {
         Logger.verbose(`${k} action loading...`);
         const start = Date.now();
-        await (this.#ctx[k] as StoreAction)(...args);
-        Logger.verbose(`=> ${k} action dispatched (${Date.now() - start}ms)`);
+        try {
+          const result = await (this.#ctx[k] as StoreAction)(...args);
+          Logger.verbose(`=> ${k} action dispatched (${Date.now() - start}ms)`);
+          return result;
+        } catch (error) {
+          this.#showActionErrorMessage(k, error);
+          Logger.error(`${k} action error return: ${error instanceof Error ? error.message : String(error)}`);
+          throw error;
+        }
       };
     }
   }
 
+  #showActionErrorMessage(actionKey: string, error: unknown) {
+    const showMessage = this.#ctx.showMessage;
+    if (typeof showMessage !== "function") return;
+    try {
+      const lang = Translator.getActiveLocale() ?? parseAkanI18nEnv().defaultLocale;
+      const errorKey = getActionErrorKey(error);
+      const content = Translator.translateByLocale(lang, errorKey, getActionErrorData(error));
+      showMessage({ type: "error", key: actionKey, duration: 3, content });
+    } catch (messageError) {
+      Logger.warn(
+        `Failed to show ${actionKey} action error message: ${
+          messageError instanceof Error ? messageError.message : String(messageError)
+        }`,
+      );
+    }
+  }
+
   #buildSlices(store: RootStoreCls) {
     Object.entries(store.slice).forEach(([refName, sliceObj]) => {
       Object.entries(sliceObj).forEach(([suffix, serializedSlice]) => {

package/types/client/csrTypes.d.ts

@@ -122,6 +122,7 @@ export interface LayoutModule {
     manifest?: WebAppManifest;
     theme?: string;
     reconnect?: boolean;
+    wsConnect?: boolean;
     layoutStyle?: "mobile" | "web";
     gaTrackingId?: string;
     Loading?: LayoutLoadingRender;

package/types/client/translator.d.ts

@@ -11,6 +11,7 @@ export declare class Translator {
     hasDictionary(lang: string): boolean;
     static setActiveLocale(lang: string | undefined): void;
     static getActiveLocale(): string | undefined;
+    static translateByLocale(lang: string, key: string, param?: Record<string, string | number>): string;
     static seed(lang: string, dict: Dictionary | undefined): void;
     translate(lang: string, key: string, param?: Record<string, string | number>): string;
     getDictionary(lang: string): Promise<Dictionary>;

package/types/common/fileUpload.d.ts

@@ -1,7 +1,7 @@
 interface FileUploadSerializedEndpoint {
     fileUpload?: boolean;
 }
-export interface FileUploadSerializedSignal {
+interface FileUploadSerializedSignal {
     prefix?: string;
     endpoint: Record<string, FileUploadSerializedEndpoint>;
 }

package/types/common/index.d.ts

@@ -1,7 +1,7 @@
 export { applyMixins } from "./applyMixins.d.ts";
 export { capitalize } from "./capitalize.d.ts";
 export { deepObjectify } from "./deepObjectify.d.ts";
-export * from "./fileUpload.d.ts";
+export { type FileUploadCapability, fileUploadContract, resolveFileUploadCapability, } from "./fileUpload.d.ts";
 export { formatNumber } from "./formatNumber.d.ts";
 export { formatPhone } from "./formatPhone.d.ts";
 export { getAllPropertyDescriptors } from "./getAllPropertyDescriptors.d.ts";

package/types/server/ssrTypes.d.ts

@@ -34,12 +34,11 @@ export interface SsrFromRscInput {
      * guaranteeing one React instance across rscClient and every route
      * chunk.
      *
-     * Injection happens via a stream transform, not React children, because
-     * React Fizz hoists `<link rel="modulepreload">` (generated from
-     * `bootstrapModules`) to the top of `<head>`, which would otherwise sit
-     * before any importmap rendered via JSX. The spec is strict: import maps
-     * must be acquired before any module script fetch starts, including
-     * modulepreload.
+     * Injection happens via a stream transform, not React children, because the
+     * spec is strict: import maps must be acquired before any module script fetch
+     * starts, including modulepreload. Akan writes bootstrap module preloads
+     * directly after this importmap and delays the executable module script until
+     * the Fizz HTML stream has completed.
      */
     importmap?: Record<string, string>;
     theme?: AkanTheme;

package/types/service/base.service.d.ts

@@ -8,7 +8,6 @@ declare const BaseService_base: import("./serve.d.ts").ServiceCls<"base", {}, {
 }>;
 export declare class BaseService extends BaseService_base {
     publishPing(): void;
-    cleanup(): Promise<void>;
 }
 export declare const srv: {
     base: ServiceModel<typeof BaseService, any, any, {

package/types/service/injectInfo.d.ts

@@ -76,9 +76,15 @@ export declare const injectionBuilder: (parentRefName: string) => {
         get?: GetFn;
         set?: (value: ReturnType<GetFn>) => GetFieldValue<ValueRef, ExplicitType>;
     }) => InjectInfo<"memory", Local extends true ? MapConstructor extends ValueRef ? Map<string, FieldToValue<MapValue>> : (DefaultValue extends never ? true : false) extends true ? (never extends GetFn ? GetFieldValue<ValueRef, ExplicitType, MapValue> : ReturnType<GetFn>) | null : never extends GetFn ? GetFieldValue<ValueRef, ExplicitType, MapValue> : ReturnType<GetFn> : MapConstructor extends ValueRef ? {
-        get: (key: string) => Promise<FieldToValue<MapValue>>;
-        set: (key: string, value: FieldToValue<MapValue>) => Promise<void>;
+        get: (key: string) => Promise<(never extends GetFn ? FieldToValue<MapValue> : ReturnType<GetFn>) | undefined>;
+        set: (key: string, value: never extends GetFn ? FieldToValue<MapValue> : ReturnType<GetFn>) => Promise<void>;
         delete: (key: string) => Promise<void>;
+        getOrInsert: (key: string, value: never extends GetFn ? FieldToValue<MapValue> : ReturnType<GetFn>) => Promise<never extends GetFn ? FieldToValue<MapValue> : ReturnType<GetFn>>;
+        getOrInsertComputed: (key: string, compute: (key: string) => (never extends GetFn ? FieldToValue<MapValue> : ReturnType<GetFn>) | Promise<never extends GetFn ? FieldToValue<MapValue> : ReturnType<GetFn>>) => Promise<never extends GetFn ? FieldToValue<MapValue> : ReturnType<GetFn>>;
+        keys: () => Promise<string[]>;
+        entries: () => Promise<[string, never extends GetFn ? FieldToValue<MapValue> : ReturnType<GetFn>][]>;
+        forEach: (callback: (value: never extends GetFn ? FieldToValue<MapValue> : ReturnType<GetFn>, key: string) => void | Promise<void>) => Promise<void>;
+        clear: () => Promise<void>;
     } : {
         get: () => Promise<(DefaultValue extends never ? true : false) extends true ? (never extends GetFn ? GetFieldValue<ValueRef, ExplicitType, MapValue> : ReturnType<GetFn>) | null : never extends GetFn ? GetFieldValue<ValueRef, ExplicitType, MapValue> : ReturnType<GetFn>>;
         set: (value: (DefaultValue extends never ? true : false) extends true ? (never extends GetFn ? GetFieldValue<ValueRef, ExplicitType, MapValue> : ReturnType<GetFn>) | null : never extends GetFn ? GetFieldValue<ValueRef, ExplicitType, MapValue> : ReturnType<GetFn>) => Promise<void>;

package/types/service/predefinedAdaptor/cache.adaptor.d.ts

@@ -12,6 +12,9 @@ export interface CacheAdaptor {
     }): Promise<void>;
     hget<T extends string | number | Buffer>(topic: string, key: string, subKey: string): Promise<T | undefined>;
     hdelete(topic: string, key: string, subKey: string): Promise<void>;
+    hkeys(topic: string, key: string): Promise<string[]>;
+    hentries<T extends string | number | Buffer>(topic: string, key: string): Promise<[string, T][]>;
+    hclear(topic: string, key: string): Promise<void>;
 }
 interface RedisEnv extends BaseEnv {
     redis?: {
@@ -34,6 +37,9 @@ export declare class RedisCache extends RedisCache_base implements CacheAdaptor
     }): Promise<void>;
     hget<T extends string | number | Buffer>(topic: string, key: string, subKey: string): Promise<T | undefined>;
     hdelete(topic: string, key: string, subKey: string): Promise<void>;
+    hkeys(topic: string, key: string): Promise<string[]>;
+    hentries<T extends string | number | Buffer>(topic: string, key: string): Promise<[string, T][]>;
+    hclear(topic: string, key: string): Promise<void>;
     getClient(): Redis;
     onDestroy(): Promise<void>;
 }

package/types/service/predefinedAdaptor/database.adaptor.d.ts

@@ -1,7 +1,7 @@
 import { Database } from "bun:sqlite";
 import type { Client as LibsqlClient } from "@libsql/client";
 import { type BaseEnv, type PromiseOrObject } from "akanjs/base";
-import type { ConstantModel } from "akanjs/constant";
+import { type ConstantModel } from "akanjs/constant";
 import { type DatabaseModel, type DocumentQuery, type DocumentSchema, type DocumentUpdate, type DocumentUpdateOptions, type SchemaOf } from "akanjs/document";
 import type { Sql } from "postgres";
 export interface SqliteDatabaseConfig {
@@ -256,6 +256,8 @@ export declare class SqliteDocumentStore {
     private decodeFieldValue;
     private decodeMapValue;
     private decodeNestedValue;
+    private normalizeWriteValue;
+    private fillScalarDefaults;
     hydrate(data: DocumentRecord, originalData?: DocumentRecord): any;
     private runHooks;
     private insertStmt;

package/types/service/predefinedAdaptor/solidCache.adaptor.d.ts

@@ -18,5 +18,8 @@ export declare class SolidCache extends SolidCache_base implements CacheAdaptor
     }): Promise<void>;
     hget<T extends string | number | Buffer>(topic: string, key: string, subKey: string): Promise<T | undefined>;
     hdelete(topic: string, key: string, subKey: string): Promise<void>;
+    hkeys(topic: string, key: string): Promise<string[]>;
+    hentries<T extends string | number | Buffer>(topic: string, key: string): Promise<[string, T][]>;
+    hclear(topic: string, key: string): Promise<void>;
 }
 export {};

package/types/signal/base.signal.d.ts

@@ -18,9 +18,6 @@ declare const BaseEndpoint_base: import("./endpoint.d.ts").EndpointCls<import("a
     pingQuery: import("./endpointInfo.d.ts").EndpointInfo<"query", {
         baseService: import("akanjs/service").BaseService;
     }, [string], [arg?: string | null | undefined], [], [arg: string | undefined], StringConstructor, string, string, true>;
-    cleanup: import("./endpointInfo.d.ts").EndpointInfo<"mutation", {
-        baseService: import("akanjs/service").BaseService;
-    }, [], [], [], [], BooleanConstructor, boolean, Promise<boolean>, false>;
     wsPing: import("./endpointInfo.d.ts").EndpointInfo<"message", {
         baseService: import("akanjs/service").BaseService;
     }, [string], [arg?: string | null | undefined], [], [arg: string | undefined], StringConstructor, string, string, false>;

package/types/signal/types.d.ts

@@ -60,6 +60,8 @@ export interface SignalOption<Response = any, Nullable extends boolean = false,
     middlewares?: MiddlewareCls[];
     prefix?: false | string;
     globalPrefix?: false;
+    /** Marks this mutation as the framework file-upload endpoint (see resolveFileUploadCapability). */
+    fileUpload?: boolean;
     scheduleType?: "init" | "destroy" | "cron" | "interval" | "timeout";
     scheduleCron?: string;
     scheduleTime?: number;
@@ -72,6 +74,7 @@ interface SerializedSignalOption {
     prefix?: false | string;
     globalPrefix?: false;
     guards?: string[];
+    fileUpload?: boolean;
 }
 export interface SerializedSlice extends SerializedSignalOption {
 }

package/types/ui/Dialog/Modal.d.ts

@@ -6,4 +6,4 @@ export interface ModalProps {
     children?: ReactNode;
     onCancel?: () => void;
 }
-export declare const Modal: ({ className, bodyClassName, confirmClose, children, onCancel }: ModalProps) => import("react/jsx-runtime").JSX.Element;
+export declare const Modal: ({ className, bodyClassName, confirmClose, children, onCancel }: ModalProps) => import("react").ReactPortal | null;

package/types/ui/Dialog/index.d.ts

@@ -1,7 +1,7 @@
 import { type ProviderProps } from "./Provider.d.ts";
 export declare const Dialog: {
     ({ children, ...props }: ProviderProps): import("react/jsx-runtime").JSX.Element;
-    Modal: ({ className, bodyClassName, confirmClose, children, onCancel }: import("./Modal.d.ts").ModalProps) => import("react/jsx-runtime").JSX.Element;
+    Modal: ({ className, bodyClassName, confirmClose, children, onCancel }: import("./Modal.d.ts").ModalProps) => import("react").ReactPortal | null;
     Title: ({ children }: import("./Title.d.ts").TitleProps) => null;
     Action: ({ children }: import("./Action.d.ts").ActionProps) => null;
     Trigger: ({ className, children }: import("./Trigger.d.ts").TriggerProps) => import("react/jsx-runtime").JSX.Element;

package/types/ui/Modal.d.ts

@@ -16,15 +16,4 @@ export interface ModalProps {
     /** Ask for close confirmation before dismissing. */
     confirmClose?: boolean;
 }
-export declare const Modal: {
-    ({ className, title, action, open, onCancel, bodyClassName, children, confirmClose, }: ModalProps): import("react/jsx-runtime").JSX.Element;
-    Window: ({ open, onCancel, title, children }: WindowProps) => import("react/jsx-runtime").JSX.Element | null;
-};
-interface WindowProps {
-    open: boolean;
-    onCancel: () => void;
-    title: ReactNode;
-    children: ReactNode;
-}
-export declare const Window: ({ open, onCancel, title, children }: WindowProps) => import("react/jsx-runtime").JSX.Element | null;
-export {};
+export declare const Modal: ({ className, title, action, open, onCancel, bodyClassName, children, confirmClose, }: ModalProps) => import("react/jsx-runtime").JSX.Element;

package/types/ui/System/CSR.d.ts

@@ -5,7 +5,7 @@ export declare const CSR: {
     ({ children }: {
         children: ReactNode;
     }): import("react/jsx-runtime").JSX.Element;
-    Provider: ({ className, appName, params, head, manifest, env, theme, prefix, children, gaTrackingId, fonts, layoutStyle, reconnect, of, }: CSRProviderProps) => import("react/jsx-runtime").JSX.Element;
+    Provider: ({ className, appName, params, head, manifest, env, theme, prefix, children, gaTrackingId, fonts, layoutStyle, reconnect, wsConnect, of, }: CSRProviderProps) => import("react/jsx-runtime").JSX.Element;
     Wrapper: ({ children, lang, head, manifest, fonts, appName, className, prefix, layoutStyle, }: CSRWrapperProps) => import("react/jsx-runtime").JSX.Element;
     Inner: () => import("react/jsx-runtime").JSX.Element;
     Bridge: ({ lang, prefix }: CSRBridgeProps) => null;
@@ -13,7 +13,7 @@ export declare const CSR: {
 export type CSRProviderProps = ProviderProps & {
     fonts: ReactFont[];
 };
-declare const CSRProvider: ({ className, appName, params, head, manifest, env, theme, prefix, children, gaTrackingId, fonts, layoutStyle, reconnect, of, }: CSRProviderProps) => import("react/jsx-runtime").JSX.Element;
+declare const CSRProvider: ({ className, appName, params, head, manifest, env, theme, prefix, children, gaTrackingId, fonts, layoutStyle, reconnect, wsConnect, of, }: CSRProviderProps) => import("react/jsx-runtime").JSX.Element;
 interface CSRWrapperProps {
     className?: string;
     appName: string;

package/types/ui/System/Client.d.ts

@@ -6,9 +6,9 @@ import { type HTMLAttributes, type ReactNode, type RefObject } from "react";
 export declare const Client: {
     (): import("react/jsx-runtime").JSX.Element;
     Wrapper: ({ children, theme, lang, dictionary, signals, reconnect, }: ClientWrapperProps) => import("react/jsx-runtime").JSX.Element;
-    Bridge: ({ env, lang, theme, prefix, gaTrackingId, }: ClientBridgeProps) => "" | import("react/jsx-runtime").JSX.Element | undefined;
+    Bridge: ({ env, lang, theme, prefix, gaTrackingId, wsConnect }: ClientBridgeProps) => "" | import("react/jsx-runtime").JSX.Element | undefined;
     Inner: () => import("react/jsx-runtime").JSX.Element;
-    SsrBridge: ({ lang, prefix, }: ClientSsrBridgeProps) => null;
+    SsrBridge: ({ lang, prefix }: ClientSsrBridgeProps) => null;
 };
 interface ClientWrapperProps {
     children: ReactNode;
@@ -36,12 +36,13 @@ interface ClientBridgeProps {
     theme?: AkanTheme;
     prefix?: string;
     gaTrackingId?: string;
+    wsConnect?: boolean;
 }
-export declare const ClientBridge: ({ env, lang, theme, prefix, gaTrackingId, }: ClientBridgeProps) => "" | import("react/jsx-runtime").JSX.Element | undefined;
+export declare const ClientBridge: ({ env, lang, theme, prefix, gaTrackingId, wsConnect }: ClientBridgeProps) => "" | import("react/jsx-runtime").JSX.Element | undefined;
 export declare const ClientInner: () => import("react/jsx-runtime").JSX.Element;
 interface ClientSsrBridgeProps {
     lang: string;
     prefix?: string;
 }
-export declare const ClientSsrBridge: ({ lang, prefix, }: ClientSsrBridgeProps) => null;
+export declare const ClientSsrBridge: ({ lang, prefix }: ClientSsrBridgeProps) => null;
 export {};

package/types/ui/System/Common.d.ts

@@ -28,6 +28,8 @@ export interface ProviderProps {
     layoutStyle?: "mobile" | "web";
     /** Enable reconnect helper. Defaults to local operation mode in CSR. */
     reconnect?: boolean;
+    /** Connect the client WebSocket runtime after the browser loads. */
+    wsConnect?: boolean;
     /** Active-locale dictionary injected by the server (SSR only) to seed the client Translator. */
     dictionary?: Record<string, Record<string, unknown>>;
     /**

package/types/ui/System/SSR.d.ts

@@ -3,13 +3,13 @@ import { type ReactNode } from "react";
 import { type ProviderProps } from "./Common.d.ts";
 export declare const SSR: {
     (): import("react/jsx-runtime").JSX.Element;
-    Provider: ({ className, appName, params, head, manifest, env, gaTrackingId, children, theme, prefix, fonts, layoutStyle, reconnect, dictionary, allDictionary, of, }: SSRProviderProps) => import("react/jsx-runtime").JSX.Element;
+    Provider: ({ className, appName, params, head, manifest, env, gaTrackingId, children, theme, prefix, fonts, layoutStyle, reconnect, wsConnect, dictionary, allDictionary, of, }: SSRProviderProps) => import("react/jsx-runtime").JSX.Element;
     Wrapper: ({ children, head, manifest, fonts, className, prefix, layoutStyle, }: SSRWrapperProps) => import("react/jsx-runtime").JSX.Element;
 };
 export type SSRProviderProps = ProviderProps & {
     fonts?: ReactFont[];
 };
-declare const SSRProvider: ({ className, appName, params, head, manifest, env, gaTrackingId, children, theme, prefix, fonts, layoutStyle, reconnect, dictionary, allDictionary, of, }: SSRProviderProps) => import("react/jsx-runtime").JSX.Element;
+declare const SSRProvider: ({ className, appName, params, head, manifest, env, gaTrackingId, children, theme, prefix, fonts, layoutStyle, reconnect, wsConnect, dictionary, allDictionary, of, }: SSRProviderProps) => import("react/jsx-runtime").JSX.Element;
 interface SSRWrapperProps {
     className?: string;
     appName: string;